Что означает код HRESULT 0x887E0001 (D3D12_ERROR_ADAPTER_NOT_FOUND)?

Код состояния / ошибки:		Категория:

Имя константы:
Источник:		Операционная система:
Описание: Переданный двоичный блок не соответствует адаптеру, для которого было создано устройство.

Предыдущий	Следующий
D3D11_ERROR_DEFERRED_CONTEXT_MAP_WITHOUT_INITIAL_DISCARD	D3D12_ERROR_DRIVER_VERSION_MISMATCH

D3D12_ERROR_ADAPTER_NOT_FOUND

D3D12_ERROR_ADAPTER_NOT_FOUND: граница сбоя, проверка и исправление

D3D12_ERROR_ADAPTER_NOT_FOUND имеет значение 0x887E0001 (-2005008383 в знаковом 32-битном представлении). Переданный двоичный блок не соответствует адаптеру, для которого было создано устройство.

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

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

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

Для D3D12_ERROR_ADAPTER_NOT_FOUND практическая ценность кода появляется только вместе с контекстом: параметрами вызова, идентичностью процесса, состоянием объекта и предшествующим низкоуровневым результатом.

В имени D3D12_ERROR_ADAPTER_NOT_FOUND закодированы ориентиры для расследования: D3D12 — технический признак «d3d12»; ADAPTER — графический адаптер; NOT — отсутствие требуемого условия; FOUND — поиск объекта. Для D3D12_ERROR_ADAPTER_NOT_FOUND эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.

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

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

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

При разборе D3D12_ERROR_ADAPTER_NOT_FOUND обозначение NOT связывает код с темой «отсутствие требуемого условия». До повторной проверки D3D12_ERROR_ADAPTER_NOT_FOUND сохраните входные данные без нормализации.

Маркер FOUND в D3D12_ERROR_ADAPTER_NOT_FOUND направляет проверку на поиск объекта. Для D3D12_ERROR_ADAPTER_NOT_FOUND сопоставьте этот признак с фактическими параметрами первого неуспешного вызова.

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

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

Для воспроизводимого отчёта по D3D12_ERROR_ADAPTER_NOT_FOUND нужно проверить результат GetDeviceRemovedReason при признаках потери устройства.
В первичном журнале по D3D12_ERROR_ADAPTER_NOT_FOUND нужно записать API-вызов, параметры, формат ресурса и состояние устройства.

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

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

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

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

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

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

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