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