| Предыдущий | Следующий |
| D2DERR_CYCLIC_GRAPH | D2DERR_OUTSTANDING_BITMAP_REFERENCES |
D2DERR_BITMAP_CANNOT_DRAW
Практический разбор D2DERR_BITMAP_CANNOT_DRAW
D2DERR_BITMAP_CANNOT_DRAW — HRESULT, относящийся к области Direct2D. Растровое изображение Direct2D создано с флагом D2D1_BITMAP_OPTIONS_CANNOT_DRAW и не может использоваться как источник рисования.
Применительно к D2DERR_BITMAP_CANNOT_DRAW статус описывает контракт графического API, а не содержимое изображения само по себе. Для D2DERR_BITMAP_CANNOT_DRAW ошибка часто возникает из-за времени жизни или происхождения ресурсов.
Практический вывод для D2DERR_BITMAP_CANNOT_DRAW: этот HRESULT фиксирует описанное условие, но сам по себе не показывает, какой участник операции первым нарушил контракт. Для D2DERR_BITMAP_CANNOT_DRAW найдите первый вызов, вернувший статус, и только после этого меняйте конфигурацию подсистемы Direct2D.
Как читать имя D2DERR_BITMAP_CANNOT_DRAW
Имя D2DERR_BITMAP_CANNOT_DRAW помогает сузить поиск: BITMAP — растровое изображение; CANNOT — невозможность действия; DRAW — технический маркер «draw». Эти части имени не заменяют документацию API, но позволяют проверить, что журнал и код относятся к одному и тому же условию.
Проверка причины
Применительно к D2DERR_BITMAP_CANNOT_DRAW важно сохранить исходный контекст вызова: имя функции, параметры, состояние объекта и первый низкоуровневый статус. Для D2DERR_BITMAP_CANNOT_DRAW без этого одинаковый HRESULT может ошибочно связываться с разными причинами.
- При разборе D2DERR_BITMAP_CANNOT_DRAW сверьте размеры текстур и поддерживаемые форматы с feature level и возможностями графического адаптера.
- При разборе D2DERR_BITMAP_CANNOT_DRAW пересоздайте device-dependent resources после потери устройства вместо повторного использования старых объектов.
- При разборе D2DERR_BITMAP_CANNOT_DRAW запишите метод Direct2D, параметры ресурса, factory и render target, которым принадлежат участвующие объекты.
- При разборе D2DERR_BITMAP_CANNOT_DRAW проверьте баланс BeginDraw/EndDraw, Push/Pop, активные layer/clip и текущую target bitmap.
Диагностический минимум
- Для D2DERR_BITMAP_CANNOT_DRAW включите Direct2D debug layer и сохраните первое диагностическое сообщение перед HRESULT.
- Для D2DERR_BITMAP_CANNOT_DRAW создайте минимальную сцену с теми же ресурсами и последовательностью вызовов.
- Для D2DERR_BITMAP_CANNOT_DRAW проверяйте исправление как на аппаратном, так и на программном WARP-рендерере, если это допустимо.
Как подтвердить исправление
Применительно к D2DERR_BITMAP_CANNOT_DRAW считайте причину D2DERR_BITMAP_CANNOT_DRAW устранённой только после проверки на тех же данных и под той же учётной записью, где возник сбой, а затем выполните контрольный тест с заведомо неверным входом.
Ссылки по D2DERR_BITMAP_CANNOT_DRAW
Нужно найти другой код? Найти другой код состояния или ошибки.