Что означает код HRESULT 0x887C0002 (D3D11_ERROR_FILE_NOT_FOUND)?

 
Предыдущий Следующий
D3D11_ERROR_TOO_MANY_UNIQUE_STATE_OBJECTS D3D11_ERROR_TOO_MANY_UNIQUE_VIEW_OBJECTS

D3D11_ERROR_FILE_NOT_FOUND

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

HRESULT D3D11_ERROR_FILE_NOT_FOUND соответствует значению 0x887C0002. Его штатное описание: «Указанный файл не найден.»

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

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

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

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

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

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

Компонент имени D3D11 уточняет смысл D3D11_ERROR_FILE_NOT_FOUND: речь идёт про технический признак «d3d11». Для D3D11_ERROR_FILE_NOT_FOUND эту границу следует воспроизвести отдельно от последующей обработки ошибки.

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

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

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

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

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

  • На границе сбоя по D3D11_ERROR_FILE_NOT_FOUND нужно записать API-вызов, параметры, формат ресурса и состояние устройства.
  • Для сравнения с исправным случаем по D3D11_ERROR_FILE_NOT_FOUND нужно проверить результат GetDeviceRemovedReason при признаках потери устройства.

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

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

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

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

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

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

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