Что означает код HRESULT 0x88990012 (D2DERR_WRONG_FACTORY)?

 
Предыдущий Следующий
D2DERR_BAD_NUMBER D2DERR_LAYER_ALREADY_IN_USE

D2DERR_WRONG_FACTORY

Как диагностировать D2DERR_WRONG_FACTORY

D2DERR_WRONG_FACTORY — HRESULT, относящийся к области Direct2D. Совместно использованы объекты Direct2D, созданные разными экземплярами фабрики.

В случае D2DERR_WRONG_FACTORY этот HRESULT возвращён Direct2D. В случае D2DERR_WRONG_FACTORY для диагностики важны factory/resource domain, параметры bitmap/brush/layer и состояние цели между BeginDraw и EndDraw.

Практический вывод для D2DERR_WRONG_FACTORY: этот HRESULT фиксирует описанное условие, но сам по себе не показывает, какой участник операции первым нарушил контракт. Для D2DERR_WRONG_FACTORY найдите первый вызов, вернувший статус, и только после этого меняйте конфигурацию подсистемы Direct2D.

Как читать имя D2DERR_WRONG_FACTORY

Имя D2DERR_WRONG_FACTORY помогает сузить поиск: WRONG — несоответствующий объект; FACTORY — фабрика объектов. Эти части имени не заменяют документацию API, но позволяют проверить, что журнал и код относятся к одному и тому же условию.

Практическая диагностика

В случае D2DERR_WRONG_FACTORY важно сохранить исходный контекст вызова: имя функции, параметры, состояние объекта и первый низкоуровневый статус. В случае D2DERR_WRONG_FACTORY без этого одинаковый HRESULT может ошибочно связываться с разными причинами.

  • При разборе D2DERR_WRONG_FACTORY запишите метод Direct2D, параметры ресурса, factory и render target, которым принадлежат участвующие объекты.
  • При разборе D2DERR_WRONG_FACTORY проверьте баланс BeginDraw/EndDraw, Push/Pop, активные layer/clip и текущую target bitmap.
  • При разборе D2DERR_WRONG_FACTORY сверьте размеры текстур и поддерживаемые форматы с feature level и возможностями графического адаптера.
  • При разборе D2DERR_WRONG_FACTORY пересоздайте device-dependent resources после потери устройства вместо повторного использования старых объектов.

Как локализовать источник

  • Для D2DERR_WRONG_FACTORY проверяйте исправление как на аппаратном, так и на программном WARP-рендерере, если это допустимо.
  • Для D2DERR_WRONG_FACTORY включите Direct2D debug layer и сохраните первое диагностическое сообщение перед HRESULT.
  • Для D2DERR_WRONG_FACTORY создайте минимальную сцену с теми же ресурсами и последовательностью вызовов.

Критерий успешного исправления

В случае D2DERR_WRONG_FACTORY для D2DERR_WRONG_FACTORY недостаточно скрыть ошибку повтором. В случае D2DERR_WRONG_FACTORY после изменения воспроизведите исходную операцию, проверьте конечное состояние объекта и убедитесь, что ресурсы освобождаются без потери первичного HRESULT.

Ссылки по D2DERR_WRONG_FACTORY


Нужно найти другой код? Найти другой код состояния или ошибки.