Что означает код HRESULT 0x000D1067 (NS_S_WMG_ADVISE_DROP_TO_KEYFRAME)?

Код состояния / ошибки:

Категория:

Имя константы:

Источник:

Подсистема (Facility):

Операционная система:

Описание:

Windows Media рекомендует отбросить кадры до следующего ключевого кадра

Предыдущий	Следующий
NS_S_WMG_ADVISE_DROP_FRAME	NS_S_NEED_TO_BUY_BURN_RIGHTS

NS_S_WMG_ADVISE_DROP_TO_KEYFRAME

Windows Media рекомендует отбросить кадры до следующего ключевого кадра

NS_S_WMG_ADVISE_DROP_TO_KEYFRAME — это HRESULT 856167 (0x000D1067) Windows Media. В AllStat он описан как «временная отметка сильно опаздывает относительно текущей позиции рендеринга; рекомендуется отбросить всё до следующего ключевого кадра». Бит severity указывает на неошибочный результат, однако значение передаёт конкретное состояние, которое нельзя сводить к обычному S_OK.

В устаревшем конвейере Windows Media или состоянии Player этот статус означает сильное отставание временной отметки от текущей позиции рендеринга и рекомендацию пропустить всё до следующего ключевого кадра. Нельзя считать операцию обычно завершённой только по этому статусу , пока состояние и выходные данные компонента-владельца не согласованы.

Где встречается этот статус

Этот статус может возвращаться в callbacks источника, reader, writer или renderer Windows Media; фиксируйте точный метод и состояние объекта, а не интерпретируйте константу вне контракта этого вызова.
Этот статус может возвращаться при автоматизации через Windows Media Player SDK; фиксируйте точный метод и состояние объекта, а не интерпретируйте константу вне контракта этого вызова.
Этот статус может возвращаться в состояниях media graph, playlist, image, rights или buffering; фиксируйте точный метод и состояние объекта, а не интерпретируйте константу вне контракта этого вызова.

Поскольку этот статус является информационным статусом, языковая оболочка может показать его как успех и скрыть символическое различие. Сохраняйте исходный HRESULT, пока не отработана ветвь, специфичная для этого кода.

Данные и телеметрия

Для этого статуса сохраните временные отметки текущего и следующего ключевого кадров.
Для этого статуса сохраните кодек и структуру GOP.
Для этого статуса сохраните число пропущенных кадров.
Для этого статуса сохраните состояние сброса декодера.
Для этого статуса сохраните итоговое смещение синхронизации.

Также зафиксируйте ns_s_wmg_advise_drop_to_keyframe_operation, ns_s_wmg_advise_drop_to_keyframe_state_before, ns_s_wmg_advise_drop_to_keyframe_state_after, время UTC, идентификаторы процесса и потока, версию компонента и идентификатор корреляции. Для безопасной с точки зрения конфиденциальности диагностики NS_S_WMG_ADVISE_DROP_TO_KEYFRAME записывайте метаданные и отпечатки вместо конфиденциальных исходных значений.

Что должно быть истинно перед принятием результата

Для этого статуса убедитесь, что декодер может восстановить корректное состояние на следующем ключевом кадре, а пропущенный интервал допустим. Только такая проверка контракта подтверждает, что этот статус можно безопасно передать следующему шагу вызывающей стороны.

Возврат этого статуса может происходить уже после наблюдаемых побочных эффектов, поэтому восстановление следует начинать со сверки фактического состояния.

Правильная обработка и восстановление

Отбросьте зависимые кадры до следующего ключевого, сбросьте состояние декодера в соответствии с документацией и сообщите о пропущенном интервале. После этого при необходимости адаптируйте битрейт или использование ресурсов.

Повторяйте операцию только если документированно изменился входной параметр или состояние. Перед новым вызовом после этого статусаубедитесь, что уже выполненные побочные эффекты либо идемпотентны, либо согласованы с фактическим состоянием.

Последовательность диагностики

Зафиксируйте исходное значение 0x000D1067 до того, как оболочки, знаковое десятичное форматирование, исключения или общая обработка успеха заменят исходный статус.
Определите операцию, вернувшую этот статус, включая интерфейс или callback, сборку компонента, поток, процесс и фазу машины состояний.
Для этого статуса подтвердите решающее условие: декодирование может быть корректно восстановлено на следующем ключевом кадре, а пропущенный интервал допустим.
Проверьте каждый выходной параметр, счётчик, массив статусов, буфер, callback, состояние задачи, временную метку медиа, голос транзакции или security token, остающийся частью контракта этого статуса.
Сравните состояние непосредственно до и после этого статуса; success severity не гарантирует завершения необязательной работы или высокоуровневого действия, которого ожидал вызывающий код.
Воспроизведите этот статус на минимальном входе, сохраняющем то же условие, затем измените только зафиксированную причину и повторите операцию.

Отличие от соседних результатов

Этот статус нужно отличать от обычного S_OK и от значений того же семейства API, у которых бит severity указывает на сбой; документированное состояние определяет следующее действие.

Для этого статуса соседний HRESULT может изменить владение объектом, допустимость выходных данных или разрешённый следующий метод.

Практический сценарий

Сильно опоздавший сжатый поток уже нельзя догнать отбрасыванием одного кадра. Граф переходит к следующему ключевому кадру и возобновляет декодирование с чистым опорным состоянием.

Регрессионный тест должен воспроизвести этот статус, проверить соответствующие выходные данные и состояние, затем изменить только решающее условие и убедиться в ожидаемом соседнем результате или обычном завершении.

Ссылки

Microsoft: коды ошибок Windows Media Format SDK — официальный материал Microsoft для интерпретации этого статуса.
Microsoft: Windows Media Player SDK — официальный материал Microsoft для интерпретации этого статуса.
Microsoft: событие buffering в Windows Media Player — официальный материал Microsoft для интерпретации этого статуса.
Microsoft: значения HRESULT — официальный материал Microsoft для интерпретации этого статуса.

Нужно найти другой код? Найти другой код состояния или ошибки.