| Предыдущий | Следующий |
| NS_S_WMR_PINTYPEFULLMATCH | NS_S_WMG_ADVISE_DROP_TO_KEYFRAME |
NS_S_WMG_ADVISE_DROP_FRAME
Windows Media рекомендует отбросить опоздавший кадр
NS_S_WMG_ADVISE_DROP_FRAME — это HRESULT 856166 (0x000D1066) Windows Media. В AllStat он описан как «временная отметка опаздывает относительно текущей позиции рендеринга; рекомендуется отбросить этот кадр». Бит severity указывает на неошибочный результат, однако значение передаёт конкретное состояние, которое нельзя сводить к обычному S_OK.
В устаревшем конвейере Windows Media или состоянии Player этот статус означает, что временная отметка кадра опаздывает относительно текущей позиции вывода и кадр рекомендуется отбросить. Для этого статуса принимать результат можно по фактическому состоянию и выходным данным, а не только по сброшенному биту severity.
Где встречается этот статус
- Этот статус может возвращаться в callbacks источника, reader, writer или renderer Windows Media; фиксируйте точный метод и состояние объекта, а не интерпретируйте константу вне контракта этого вызова.
- Этот статус может возвращаться при автоматизации через Windows Media Player SDK; фиксируйте точный метод и состояние объекта, а не интерпретируйте константу вне контракта этого вызова.
- Этот статус может возвращаться в состояниях media graph, playlist, image, rights или buffering; фиксируйте точный метод и состояние объекта, а не интерпретируйте константу вне контракта этого вызова.
Поскольку этот статус является информационным статусом, языковая оболочка может показать его как успех и скрыть символическое различие. Сохраняйте исходный HRESULT, пока не отработана ветвь, специфичная для этого кода.
Данные и телеметрия
- Для этого статуса сохраните временную отметку кадра и текущую позицию.
- Для этого статуса сохраните измеренное опоздание.
- Для этого статуса сохраните порог политики отбрасывания.
- Для этого статуса сохраните тип зависимости кадра.
- Для этого статуса сохраните ошибку синхронизации аудио и видео.
Также зафиксируйте ns_s_wmg_advise_drop_frame_operation, ns_s_wmg_advise_drop_frame_state_before, ns_s_wmg_advise_drop_frame_state_afterвремя UTC, идентификаторы процесса и потока, версию компонента и correlation ID. При журналировании этого статуса удаляйте секретные данные, но сохраняйте стабильные идентификаторы и хэши, необходимые для корреляции.
Что должно быть истинно перед принятием результата
Для этого статуса убедитесь, что политика качества разрешает отбросить этот кадр без нарушения синхронизации. Эта проверка отличает обоснованный результат от кода, который игнорирует незавершённую или изменённую операцию.
Перед повтором операции классифицируйте последствия как завершённые, частичные, ожидающие, отменённые, адаптированные или терминальные.
Правильная обработка и восстановление
Предпочитайте отбрасывание, если опоздание превышает бюджет рендеринга, но фиксируйте это решение. Если число пропусков растёт, снижайте качество либо исследуйте планирование и задержку декодирования.
Повторяйте операцию только после изменения документированного входа или состояния. Не повторяйте немедленно NS_S_WMG_ADVISE_DROP_FRAME если то же стабильное состояние снова даст тот же информационный результат.
Последовательность диагностики
- Зафиксируйте исходное значение
0x000D1066до того, как оболочки, знаковое десятичное форматирование, исключения или общая обработка успеха заменят исходный статус. - Определите операцию, вернувшую этот статус, включая интерфейс или callback, сборку компонента, поток, процесс и фазу машины состояний.
- Для этого статуса подтвердите решающее условие: политика качества разрешает отбросить этот кадр, сохранив синхронизацию.
- Проверьте каждый выходной параметр, счётчик, массив статусов, буфер, callback, состояние задачи, временную метку медиа, голос транзакции или security token, остающийся частью контракта этого статуса.
- Сравните состояние непосредственно до и после этого статуса; success severity не гарантирует завершения необязательной работы или высокоуровневого действия, которого ожидал вызывающий код.
- Воспроизведите этот статус на минимальном входе, сохраняющем то же условие, затем измените только зафиксированную причину и повторите операцию.
Отличие от соседних результатов
Этот статус нужно отличать от обычного S_OK и от значений того же семейства API, у которых бит severity указывает на сбой; документированное состояние определяет следующее действие.
Различие для этого статуса определяет, должен ли вызывающий код остановиться, ждать, использовать результат или изменить состояние.
Рекомендации разработчикам и администраторам
Когда этот статус проходит через границы COM, RPC, managed code, scripting или logging, сохраняйте беззнаковое 32-битное значение. Тесты должны проверять постусловие этого статуса, а не только то, что бит severity означает успех.
Для этого статуса документируйте владельца повторов, отмены, cleanup и пользовательских сообщений. Администрирование для этого статуса должно быть направлено на компонент, вернувший результат, а не на широкие перезапуски.
Практический сценарий
Видеокадр приходит с небольшим опозданием. Рендерер отбрасывает его согласно политике низкой задержки и сохраняет синхронизацию следующего кадра со звуком.
Регрессионный тест должен воспроизвести этот статус, проверить соответствующие выходные данные и состояние, затем изменить только решающее условие и убедиться в ожидаемом соседнем результате или обычном завершении.
Ссылки
- Microsoft: коды ошибок Windows Media Format SDK — официальный материал Microsoft для интерпретации этого статуса.
- Microsoft: Windows Media Player SDK — официальный материал Microsoft для интерпретации этого статуса.
- Microsoft: событие buffering в Windows Media Player — официальный материал Microsoft для интерпретации этого статуса.
- Microsoft: значения HRESULT — официальный материал Microsoft для интерпретации этого статуса.
Нужно найти другой код? Найти другой код состояния или ошибки.