| Предыдущий | Следующий |
| D2DERR_INVALID_CALL | D2DERR_RECREATE_TARGET |
D2DERR_NO_HARDWARE_DEVICE
Что означает D2DERR_NO_HARDWARE_DEVICE и где искать причину
Код D2DERR_NO_HARDWARE_DEVICE, числовое значение 0x8899000B, фиксирует конкретный результат операции. Для этой операции отсутствует аппаратное устройство визуализации.
Для D2DERR_NO_HARDWARE_DEVICE старший бит HRESULT делает значение ошибкой. Константа D2DERR_NO_HARDWARE_DEVICE объявлена в winerror.h и относится к области «Direct2D/Direct3D и графический конвейер».
Контекст подсистемы
Для D2DERR_NO_HARDWARE_DEVICE код возникает на конкретной границе графического API: при создании ресурса, записи команд, отрисовке, представлении кадра или восстановлении устройства. Для D2DERR_NO_HARDWARE_DEVICE сначала нужно зафиксировать первый неуспешный вызов и сообщения debug layer, а не переинициализировать весь графический стек.
Для D2DERR_NO_HARDWARE_DEVICE одинаковый HRESULT может быть виден в нескольких слоях. Для D2DERR_NO_HARDWARE_DEVICE в журнале нужно отделить исходный возврат от последующих ошибок очистки, повторов и обёрток.
В имени D2DERR_NO_HARDWARE_DEVICE закодированы ориентиры для расследования: D2DERR — технический признак «d2derr»; NO — отсутствие; HARDWARE — технический признак «hardware»; DEVICE — устройство. Для D2DERR_NO_HARDWARE_DEVICE эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.
Смысл результата: признаки в имени константы
Для D2DERR_NO_HARDWARE_DEVICE часть D2DERR относится к области «технический признак «d2derr»». При разборе D2DERR_NO_HARDWARE_DEVICE проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.
Для D2DERR_NO_HARDWARE_DEVICE часть NO относится к области «отсутствие». При разборе D2DERR_NO_HARDWARE_DEVICE проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.
Для D2DERR_NO_HARDWARE_DEVICE часть HARDWARE относится к области «технический признак «hardware»». При разборе D2DERR_NO_HARDWARE_DEVICE проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.
Маркер DEVICE в D2DERR_NO_HARDWARE_DEVICE направляет проверку на устройство. Для D2DERR_NO_HARDWARE_DEVICE сопоставьте этот признак с фактическими параметрами первого неуспешного вызова.
Диагностические данные
- В первичном журнале по
D2DERR_NO_HARDWARE_DEVICEнужно зафиксировать адаптер, LUID, версию драйвера и feature level. - На границе сбоя по
D2DERR_NO_HARDWARE_DEVICEнужно собрать минимальный PIX/RenderDoc-трассировочный фрагмент, если это допустимо.
Проверка по шагам
- Для
D2DERR_NO_HARDWARE_DEVICE: Свести воспроизведение к одному ресурсу и одному графическому вызову; отдельно отметьте изменение состояния объекта. - Для
D2DERR_NO_HARDWARE_DEVICE: Проверить ограничения формата, bind flags, usage и состояния ресурса; все остальные условия оставьте неизменными. - Для
D2DERR_NO_HARDWARE_DEVICE: Сравнить поведение с WARP или другим адаптером, не меняя остальные параметры; не удаляйте исходные данные до завершения сравнения. - Для
D2DERR_NO_HARDWARE_DEVICE: Проверить переходы состояний и завершение команд перед повторным использованием; повторите шаг на исправном контрольном примере. - Для
D2DERR_NO_HARDWARE_DEVICE: После исправления повторить resize, device recreation и длительный цикл кадров; сохраните первый hresult и точное время результата.
Корректирующие действия
Корректирующее действие для D2DERR_NO_HARDWARE_DEVICE должно устранять условие «Для этой операции отсутствует аппаратное устройство визуализации» на уровне Direct2D/Direct3D и графический конвейер. Для D2DERR_NO_HARDWARE_DEVICE простое подавление HRESULT, бесконечный повтор или очистка всех настроек не доказывают восстановление контракта.
Для D2DERR_NO_HARDWARE_DEVICE зафиксируйте результат до и после изменения одними и теми же средствами. Для D2DERR_NO_HARDWARE_DEVICE сравнивайте не только HRESULT, но и конечное состояние объекта, побочные эффекты и события подсистемы.
Документация
- Microsoft: Direct2D коды ошибок — D2DERR_NO_HARDWARE_DEVICE
- Документация Direct2D — D2DERR_NO_HARDWARE_DEVICE
- Документация Direct3D — D2DERR_NO_HARDWARE_DEVICE
Нужно найти другой код? Найти другой код состояния или ошибки.