Что означает код HRESULT 0x88990028 (D2DERR_EFFECT_IS_NOT_REGISTERED)?

 
Предыдущий Следующий
D2DERR_INTERMEDIATE_TOO_LARGE D2DERR_INVALID_PROPERTY

D2DERR_EFFECT_IS_NOT_REGISTERED

D2DERR_EFFECT_IS_NOT_REGISTERED: интерпретация кода и контроль исправления

D2DERR_EFFECT_IS_NOT_REGISTERED имеет значение 0x88990028 (-2003238872 в знаковом 32-битном представлении). Переданный Unregister идентификатор CLSID не соответствует зарегистрированному эффекту.

Для D2DERR_EFFECT_IS_NOT_REGISTERED старший бит HRESULT делает значение ошибкой. Константа D2DERR_EFFECT_IS_NOT_REGISTERED объявлена в winerror.h и относится к области «Direct2D/Direct3D и графический конвейер».

Контекст подсистемы

Для D2DERR_EFFECT_IS_NOT_REGISTERED код возникает на конкретной границе графического API: при создании ресурса, записи команд, отрисовке, представлении кадра или восстановлении устройства. Для D2DERR_EFFECT_IS_NOT_REGISTERED сначала нужно зафиксировать первый неуспешный вызов и сообщения debug layer, а не переинициализировать весь графический стек.

Для D2DERR_EFFECT_IS_NOT_REGISTERED само имя кода не доказывает первопричину. Для D2DERR_EFFECT_IS_NOT_REGISTERED оно указывает, на каком контракте подсистема обнаружила нарушение; первичным считается первый вызов, который вернул HRESULT.

В имени D2DERR_EFFECT_IS_NOT_REGISTERED закодированы ориентиры для расследования: D2DERR — технический признак «d2derr»; EFFECT — технический признак «effect»; NOT — отсутствие требуемого условия; REGISTERED — технический признак «registered». Для D2DERR_EFFECT_IS_NOT_REGISTERED эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.

Смысл результата: признаки в имени константы

При разборе D2DERR_EFFECT_IS_NOT_REGISTERED обозначение D2DERR связывает код с темой «технический признак «d2derr»». До повторной проверки D2DERR_EFFECT_IS_NOT_REGISTERED сохраните входные данные без нормализации.

Для D2DERR_EFFECT_IS_NOT_REGISTERED часть EFFECT относится к области «технический признак «effect»». При разборе D2DERR_EFFECT_IS_NOT_REGISTERED проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.

Для D2DERR_EFFECT_IS_NOT_REGISTERED часть NOT относится к области «отсутствие требуемого условия». При разборе D2DERR_EFFECT_IS_NOT_REGISTERED проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.

Для D2DERR_EFFECT_IS_NOT_REGISTERED часть REGISTERED относится к области «технический признак «registered»». При разборе D2DERR_EFFECT_IS_NOT_REGISTERED проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.

Для D2DERR_EFFECT_IS_NOT_REGISTERED в техническом контексте особенно важны: CLSID. При расследовании D2DERR_EFFECT_IS_NOT_REGISTERED их следует проверять как связанные части одной операции, а не как независимые симптомы.

Диагностические данные

  • На границе сбоя по D2DERR_EFFECT_IS_NOT_REGISTERED нужно зафиксировать адаптер, LUID, версию драйвера и feature level.
  • Для сравнения с исправным случаем по D2DERR_EFFECT_IS_NOT_REGISTERED нужно собрать минимальный PIX/RenderDoc-трассировочный фрагмент, если это допустимо.

Проверка по шагам

  1. Для D2DERR_EFFECT_IS_NOT_REGISTERED: Свести воспроизведение к одному ресурсу и одному графическому вызову; повторите шаг на исправном контрольном примере.
  2. Для D2DERR_EFFECT_IS_NOT_REGISTERED: Проверить ограничения формата, bind flags, usage и состояния ресурса; сохраните первый hresult и точное время результата.
  3. Для D2DERR_EFFECT_IS_NOT_REGISTERED: Сравнить поведение с WARP или другим адаптером, не меняя остальные параметры; отдельно отметьте изменение состояния объекта.
  4. Для D2DERR_EFFECT_IS_NOT_REGISTERED: Проверить переходы состояний и завершение команд перед повторным использованием; все остальные условия оставьте неизменными.
  5. Для D2DERR_EFFECT_IS_NOT_REGISTERED: После исправления повторить resize, device recreation и длительный цикл кадров; не удаляйте исходные данные до завершения сравнения.

Корректирующие действия

Корректирующее действие для D2DERR_EFFECT_IS_NOT_REGISTERED должно устранять условие «Переданный Unregister идентификатор CLSID не соответствует зарегистрированному эффекту» на уровне CLSID. Для D2DERR_EFFECT_IS_NOT_REGISTERED простое подавление HRESULT, бесконечный повтор или очистка всех настроек не доказывают восстановление контракта.

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

Документация

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