| Предыдущий | Следующий |
| NS_S_DRM_NEEDS_INDIVIDUALIZATION | NS_S_REBOOT_REQUIRED |
NS_S_REBOOT_RECOMMENDED
После установки Windows Media рекомендуется перезагрузка
NS_S_REBOOT_RECOMMENDED — это HRESULT 862968 (0x000D2AF8) Windows Media. В AllStat он описан как «установка завершилась успешно, однако очистка некоторых файлов не закончена; для наилучшего результата рекомендуется перезагрузить компьютер». В автомате состояний Windows Media Player, Windows Media Format, DRM или Media Foundation это успешное, но содержательно значимое состояние, которое нельзя сводить к обычному S_OK.
Телеметрия и тесты должны сохранять NS_S_REBOOT_RECOMMENDED поскольку его операционный смысл отличается от S_OK.
Последовательность диагностики
- Зафиксируйте исходные
0x000D2AF8иNS_S_REBOOT_RECOMMENDEDдо того, как исключения, знаковое форматирование или общая оболочка успеха удалят символическое значение. - Определите интерфейс, метод, callback, службу, драйвер или broker, вернувший этот статусвключая версию компонента, процесс, поток и correlation ID.
- Докажите решающее условие для этого статуса : установленная функциональность уже пригодна к использованию, а оставшаяся очистка не делает текущие файлы или процессы недействительными.
- Для этого статуса проверьте каждый выходной параметр, счётчик, дескриптор объекта, callback, элемент очереди, media item, отчёт, транзакцию, элемент topology или signaling response, созданные вызовом.
- Сравните состояние непосредственно до и после этого статуса и убедитесь, что владение, время жизни, сохранение и видимые пользователю эффекты соответствуют статусу.
- Воспроизведите этот статус на минимальном входе, затем измените только предполагаемую причину и убедитесь, что возвращаемое значение или постусловие изменилось ожидаемым образом.
Где встречается этот статус
- Этот статус может появляться в callbacks библиотеки, playlist, store или UI plug-in Windows Media Player; фиксируйте точный API, объект и фазу, поскольку одинаковая числовая severity успеха не определяет состояние сама по себе.
- Этот статус может появляться при операциях source, writer, DRM, publishing point или установки Windows Media Format; фиксируйте точный API, объект и фазу, поскольку одинаковая числовая severity успеха не определяет состояние сама по себе.
- Этот статус может появляться при активации topology Media Foundation и настройке удалённых компонентов; фиксируйте точный API, объект и фазу, поскольку одинаковая числовая severity успеха не определяет состояние сама по себе.
Сохраняйте этот статус привязанным к операции, которая его вернула. Интерпретация этого статуса вне контракта этого API может превратить нормальное продолжение или частичный результат в ошибочный повтор либо ложное завершение.
Что должно быть истинно перед принятием результата
Убедитесь, что установленная функциональность уже пригодна к использованию, а незавершённая очистка не нарушает текущие файлы или работающие процессы. Вызывающая сторона должна отклонить NS_S_REBOOT_RECOMMENDED , если выходные данные и состояние не соответствуют зафиксированному условию.
Для этого статуса также убедитесь, что возвращённые данные относятся к текущему поколению операции, а не унаследованы от предыдущей попытки.
Данные и телеметрия
- Сохраните пакет и его версию.
- Сохраните список файлов, ожидающих замены или удаления.
- Сохраните процессы, удерживающие эти файлы.
- Сохраните результат проверки текущей функциональности.
- Сохраните запланированное окно перезагрузки.
Для этого статуса также зафиксируйте время UTC, идентификаторы процесса и потока, версию компонента, поколение операции и correlation ID. Не помещайте чувствительное содержимое в журналы; используйте длины, хэши, GUID и разрешённые политикой метаданные.
Отличие от соседних результатов
NS_S_REBOOT_REQUIRED не позволяет продолжать до перезагрузки; здесь работу можно продолжить, но для завершения очистки рекомендуется перезапуск системы.
Использование одной общей ветви успешного результата для этого статуса и соседнего состояния может привести к потере результата, повторению работы или неверному сообщению о завершении.
Правильная обработка и восстановление
Сообщите об успешной установке с рекомендацией перезагрузки, запланируйте её на удобное время и не утверждайте, что очистка системы полностью завершена, пока перезагрузка не выполнена.
Новая попытка после этого статуса должна запускаться вследствие содержательного изменения состояния, а не только потому, что прошло некоторое время.
Практический сценарий
Обновление кодека завершается успешно, хотя старые файлы ещё используются. Установщик заканчивает работу, рекомендует перезагрузку и проверяет текущее воспроизведение перед её откладыванием.
Регрессионный тест должен воспроизвести этот статус, проверить все соответствующие выходные данные и состояние, затем измените только решающее условие и убедитесь в обычном завершении или ожидаемом соседнем результате.
Рекомендации разработчикам и администраторам
Пакет данных для поддержки по этому статусу должен включать данные первого проявления и эффективную конфигурацию, заменяя учётные данные, лицензионные материалы, приватные медиаданные и пользовательскую информацию специфичными для этого статуса хэшами или стабильными идентификаторами.
Полный сброс системы после этого статуса не оправдан, если данные именно по этому коду не указывают на общесистемную причину. Явно определите, кто отвечает за продолжение, отмену, очистку, резервный путь и сообщение пользователю для этого статуса.
Ссылки
- Microsoft: коды ошибок и успешных результатов Windows Media Format SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: Windows Media Player SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: Media Foundation SDK — официальный материал Microsoft, относящийся к этому статусу.
- Microsoft: значения HRESULT — официальный материал Microsoft, относящийся к этому статусу.
Нужно найти другой код? Найти другой код состояния или ошибки.