| Предыдущий | Следующий |
| NS_S_WMP_UI_VERSIONMISMATCH | NS_S_WMP_LOADED_GIF_IMAGE |
NS_S_WMP_EXCEPTION
Компонент интерфейса Windows Media Player сообщил об исключении
NS_S_WMP_EXCEPTION — это HRESULT 856041 (0x000D0FE9) 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, пока не отработана ветвь, специфичная для этого кода.
Последовательность диагностики
- Зафиксируйте исходное значение
0x000D0FE9до того, как оболочки, знаковое десятичное форматирование, исключения или общая обработка успеха заменят исходный статус. - Определите операцию, вернувшую этот статус, включая интерфейс или callback, сборку компонента, поток, процесс и фазу машины состояний.
- Для этого статуса подтвердите решающее условие: исключение изолировано, а состояние проигрывателя остаётся согласованным до продолжения работы приложения.
- Проверьте каждый выходной параметр, счётчик, массив статусов, буфер, callback, состояние задачи, временную метку медиа, голос транзакции или security token, остающийся частью контракта этого статуса.
- Сравните состояние непосредственно до и после этого статуса; success severity не гарантирует завершения необязательной работы или высокоуровневого действия, которого ожидал вызывающий код.
- Воспроизведите этот статус на минимальном входе, сохраняющем то же условие, затем измените только зафиксированную причину и повторите операцию.
Данные и телеметрия
- Для этого статуса сохраните идентификатор UI-компонента или подключаемого модуля.
- Для этого статуса сохраните код исключения и стек.
- Для этого статуса сохраните текущее состояние проигрывателя.
- Для этого статуса сохраните выполняемую пользовательскую команду.
- Для этого статуса сохраните результат резервного режима или выгрузки компонента.
Также зафиксируйте ns_s_wmp_exception_operation, ns_s_wmp_exception_state_before, ns_s_wmp_exception_state_after, время UTC, идентификаторы процесса и потока, версию компонента и идентификатор корреляции. Для безопасной с точки зрения конфиденциальности диагностики NS_S_WMP_EXCEPTION записывайте метаданные и отпечатки вместо конфиденциальных исходных значений.
Правильная обработка и восстановление
Зафиксируйте компонент, сведения об исключении и текущую операцию интерфейса. Сбросьте или выгрузите затронутый компонент, а если корректность состояния нельзя подтвердить — перезапустите поверхность проигрывателя.
Повторяйте операцию только если документированно изменился входной параметр или состояние. Перед новым вызовом после этого статусаубедитесь, что уже выполненные побочные эффекты либо идемпотентны, либо согласованы с фактическим состоянием.
Практический сценарий
Компонент визуализации выдаёт исключение при смене представления. Хост выгружает его, возвращает стандартное представление и сохраняет воспроизведение вместо игнорирования исключения.
Регрессионный тест должен воспроизвести этот статус, проверить соответствующие выходные данные и состояние, затем изменить только решающее условие и убедиться в ожидаемом соседнем результате или обычном завершении.
Отличие от соседних результатов
Этот статус нужно отличать от обычного 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 для интерпретации этого статуса.
Нужно найти другой код? Найти другой код состояния или ошибки.