| Предыдущий | Следующий |
| D3D10_ERROR_TOO_MANY_UNIQUE_STATE_OBJECTS | DXGI_ERROR_INVALID_CALL |
D3D10_ERROR_FILE_NOT_FOUND
D3D10_ERROR_FILE_NOT_FOUND: значение HRESULT и практическая диагностика
HRESULT D3D10_ERROR_FILE_NOT_FOUND соответствует значению 0x88790002. Его штатное описание: «Указанный файл не найден.»
Для D3D10_ERROR_FILE_NOT_FOUND старший бит HRESULT делает значение ошибкой. Константа D3D10_ERROR_FILE_NOT_FOUND объявлена в winerror.h и относится к области «Direct2D/Direct3D и графический конвейер».
Контекст подсистемы
Для D3D10_ERROR_FILE_NOT_FOUND код возникает на конкретной границе графического API: при создании ресурса, записи команд, отрисовке, представлении кадра или восстановлении устройства. Для D3D10_ERROR_FILE_NOT_FOUND сначала нужно зафиксировать первый неуспешный вызов и сообщения debug layer, а не переинициализировать весь графический стек.
Для D3D10_ERROR_FILE_NOT_FOUND не следует начинать с очистки состояния или переустановки компонента. Для D3D10_ERROR_FILE_NOT_FOUND сначала необходимо привязать результат к одному вызову, объекту и поколению его состояния.
В имени D3D10_ERROR_FILE_NOT_FOUND закодированы ориентиры для расследования: D3D10 — технический признак «d3d10»; FILE — файл; NOT — отсутствие требуемого условия; FOUND — поиск объекта. Для D3D10_ERROR_FILE_NOT_FOUND эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.
Смысл результата: признаки в имени константы
Маркер D3D10 в D3D10_ERROR_FILE_NOT_FOUND направляет проверку на технический признак «d3d10». Для D3D10_ERROR_FILE_NOT_FOUND сопоставьте этот признак с фактическими параметрами первого неуспешного вызова.
Компонент имени FILE уточняет смысл D3D10_ERROR_FILE_NOT_FOUND: речь идёт про файл. Для D3D10_ERROR_FILE_NOT_FOUND эту границу следует воспроизвести отдельно от последующей обработки ошибки.
Для D3D10_ERROR_FILE_NOT_FOUND часть NOT относится к области «отсутствие требуемого условия». При разборе D3D10_ERROR_FILE_NOT_FOUND проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.
Компонент имени FOUND уточняет смысл D3D10_ERROR_FILE_NOT_FOUND: речь идёт про поиск объекта. Для D3D10_ERROR_FILE_NOT_FOUND эту границу следует воспроизвести отдельно от последующей обработки ошибки.
Для D3D10_ERROR_FILE_NOT_FOUND в техническом контексте особенно важны: отладочный слой Direct3D. При расследовании D3D10_ERROR_FILE_NOT_FOUND их следует проверять как связанные части одной операции, а не как независимые симптомы.
Диагностические данные
- Для воспроизводимого отчёта по
D3D10_ERROR_FILE_NOT_FOUNDнужно зафиксировать адаптер, LUID, версию драйвера и feature level. - В первичном журнале по
D3D10_ERROR_FILE_NOT_FOUNDнужно собрать минимальный PIX/RenderDoc-трассировочный фрагмент, если это допустимо.
Проверка по шагам
- Для
D3D10_ERROR_FILE_NOT_FOUND: Свести воспроизведение к одному ресурсу и одному графическому вызову; не удаляйте исходные данные до завершения сравнения. - Для
D3D10_ERROR_FILE_NOT_FOUND: Проверить ограничения формата, bind flags, usage и состояния ресурса; повторите шаг на исправном контрольном примере. - Для
D3D10_ERROR_FILE_NOT_FOUND: Сравнить поведение с WARP или другим адаптером, не меняя остальные параметры; сохраните первый hresult и точное время результата. - Для
D3D10_ERROR_FILE_NOT_FOUND: Проверить переходы состояний и завершение команд перед повторным использованием; отдельно отметьте изменение состояния объекта. - Для
D3D10_ERROR_FILE_NOT_FOUND: После исправления повторить resize, device recreation и длительный цикл кадров; все остальные условия оставьте неизменными.
Корректирующие действия
Корректирующее действие для D3D10_ERROR_FILE_NOT_FOUND должно устранять условие «Указанный файл не найден» на уровне отладочный слой Direct3D. Для D3D10_ERROR_FILE_NOT_FOUND простое подавление HRESULT, бесконечный повтор или очистка всех настроек не доказывают восстановление контракта.
Для D3D10_ERROR_FILE_NOT_FOUND контрольный прогон должен включать успешный путь, повтор операции после изменения состояния и корректное освобождение ресурсов. Для D3D10_ERROR_FILE_NOT_FOUND один случайный успех недостаточен.
Документация
- Microsoft: Microsoft: Direct3D 10 return codes — D3D10_ERROR_FILE_NOT_FOUND
- Microsoft: Microsoft: Direct3D 11 return codes — D3D10_ERROR_FILE_NOT_FOUND
- Microsoft: Microsoft: Direct3D 12 return codes — D3D10_ERROR_FILE_NOT_FOUND
- Microsoft: Microsoft: Use the Direct3D 11 debug layer — D3D10_ERROR_FILE_NOT_FOUND
- Документация Direct2D — D3D10_ERROR_FILE_NOT_FOUND
Нужно найти другой код? Найти другой код состояния или ошибки.