| Предыдущий | Следующий |
| D2DERR_INTERNAL_ERROR | D2DERR_INVALID_CALL |
D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED
Практический разбор D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED
D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED — HRESULT, относящийся к области Direct2D. Графическое устройство не поддерживает формат дисплея, необходимый Direct2D для рендеринга.
В случае D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED статус описывает контракт графического API, а не содержимое изображения само по себе. В случае D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED ошибка часто возникает из-за времени жизни или происхождения ресурсов.
Практический вывод для D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED: этот HRESULT фиксирует описанное условие, но сам по себе не показывает, какой участник операции первым нарушил контракт. Для D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED найдите первый вызов, вернувший статус, и только после этого меняйте конфигурацию подсистемы Direct2D.
Как читать имя D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED
Имя D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED помогает сузить поиск: DISPLAY — дисплей; FORMAT — формат данных; NOT — отрицание условия; SUPPORTED — поддерживаемая возможность. Эти части имени не заменяют документацию API, но позволяют проверить, что журнал и код относятся к одному и тому же условию.
Проверка причины
В случае D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED ошибка описывает несовместимость возможностей или версий. В случае D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED сначала определите фактически загруженный компонент и поддерживаемый им набор функций.
- Для D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED сопоставьте версии клиента, сервера, драйвера или формата и проверьте документированную поддержку требуемой возможности.
- При разборе D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED пересоздайте device-dependent resources после потери устройства вместо повторного использования старых объектов.
- При разборе D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED запишите метод Direct2D, параметры ресурса, factory и render target, которым принадлежат участвующие объекты.
- При разборе D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED проверьте баланс BeginDraw/EndDraw, Push/Pop, активные layer/clip и текущую target bitmap.
- При разборе D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED сверьте размеры текстур и поддерживаемые форматы с feature level и возможностями графического адаптера.
Какие данные собрать
- Для D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED включите Direct2D debug layer и сохраните первое диагностическое сообщение перед HRESULT.
- Для D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED создайте минимальную сцену с теми же ресурсами и последовательностью вызовов.
- Для D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED проверяйте исправление как на аппаратном, так и на программном WARP-рендерере, если это допустимо.
Критерий успешного исправления
В случае D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED проверка исправления D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED должна включать успешный рабочий путь, предсказуемый отказ на некорректном входе и отсутствие новых предупреждений в журналах подсистемы Direct2D.
Ссылки по D2DERR_DISPLAY_FORMAT_NOT_SUPPORTED
Нужно найти другой код? Найти другой код состояния или ошибки.