| Предыдущий | Следующий |
| D2DERR_WIN32_ERROR | D2DERR_TEXT_EFFECT_IS_WRONG_TYPE |
D2DERR_TARGET_NOT_GDI_COMPATIBLE
Что означает D2DERR_TARGET_NOT_GDI_COMPATIBLE
D2DERR_TARGET_NOT_GDI_COMPATIBLE — HRESULT, относящийся к области Direct2D. Цель рендеринга Direct2D не создана с поддержкой взаимодействия с GDI.
В случае D2DERR_TARGET_NOT_GDI_COMPATIBLE статус описывает контракт графического API, а не содержимое изображения само по себе. Применительно к D2DERR_TARGET_NOT_GDI_COMPATIBLE ошибка часто возникает из-за времени жизни или происхождения ресурсов.
Практический вывод для D2DERR_TARGET_NOT_GDI_COMPATIBLE: этот HRESULT фиксирует описанное условие, но сам по себе не показывает, какой участник операции первым нарушил контракт. Для D2DERR_TARGET_NOT_GDI_COMPATIBLE найдите первый вызов, вернувший статус, и только после этого меняйте конфигурацию подсистемы Direct2D.
Как читать имя D2DERR_TARGET_NOT_GDI_COMPATIBLE
Имя D2DERR_TARGET_NOT_GDI_COMPATIBLE помогает сузить поиск: TARGET — цель операции; NOT — отрицание условия; GDI — технический маркер «gdi»; COMPATIBLE — технический маркер «compatible». Эти части имени не заменяют документацию API, но позволяют проверить, что журнал и код относятся к одному и тому же условию.
Разбор условия ошибки
В случае D2DERR_TARGET_NOT_GDI_COMPATIBLE важно сохранить исходный контекст вызова: имя функции, параметры, состояние объекта и первый низкоуровневый статус. Применительно к D2DERR_TARGET_NOT_GDI_COMPATIBLE без этого одинаковый HRESULT может ошибочно связываться с разными причинами.
- При разборе D2DERR_TARGET_NOT_GDI_COMPATIBLE пересоздайте device-dependent resources после потери устройства вместо повторного использования старых объектов.
- При разборе D2DERR_TARGET_NOT_GDI_COMPATIBLE запишите метод Direct2D, параметры ресурса, factory и render target, которым принадлежат участвующие объекты.
- При разборе D2DERR_TARGET_NOT_GDI_COMPATIBLE проверьте баланс BeginDraw/EndDraw, Push/Pop, активные layer/clip и текущую target bitmap.
- При разборе D2DERR_TARGET_NOT_GDI_COMPATIBLE сверьте размеры текстур и поддерживаемые форматы с feature level и возможностями графического адаптера.
Как локализовать источник
- Для D2DERR_TARGET_NOT_GDI_COMPATIBLE проверяйте исправление как на аппаратном, так и на программном WARP-рендерере, если это допустимо.
- Для D2DERR_TARGET_NOT_GDI_COMPATIBLE включите Direct2D debug layer и сохраните первое диагностическое сообщение перед HRESULT.
- Для D2DERR_TARGET_NOT_GDI_COMPATIBLE создайте минимальную сцену с теми же ресурсами и последовательностью вызовов.
Граница корректного решения
В случае D2DERR_TARGET_NOT_GDI_COMPATIBLE проверка исправления D2DERR_TARGET_NOT_GDI_COMPATIBLE должна включать успешный рабочий путь, предсказуемый отказ на некорректном входе и отсутствие новых предупреждений в журналах подсистемы Direct2D.
Ссылки по D2DERR_TARGET_NOT_GDI_COMPATIBLE
Нужно найти другой код? Найти другой код состояния или ошибки.