| Предыдущий | Следующий |
| D2DERR_WRONG_RESOURCE_DOMAIN | D2DERR_RENDER_TARGET_HAS_LAYER_OR_CLIPRECT |
D2DERR_PUSH_POP_UNBALANCED
Как диагностировать D2DERR_PUSH_POP_UNBALANCED
D2DERR_PUSH_POP_UNBALANCED — HRESULT, относящийся к области Direct2D. В последовательности команд Direct2D нарушен баланс операций сохранения и восстановления состояния: одному Push не соответствует Pop либо наоборот.
Применительно к D2DERR_PUSH_POP_UNBALANCED этот HRESULT возвращён Direct2D. Применительно к D2DERR_PUSH_POP_UNBALANCED для диагностики важны factory/resource domain, параметры bitmap/brush/layer и состояние цели между BeginDraw и EndDraw.
Практический вывод для D2DERR_PUSH_POP_UNBALANCED: этот HRESULT фиксирует описанное условие, но сам по себе не показывает, какой участник операции первым нарушил контракт. Для D2DERR_PUSH_POP_UNBALANCED найдите первый вызов, вернувший статус, и только после этого меняйте конфигурацию подсистемы Direct2D.
Как читать имя D2DERR_PUSH_POP_UNBALANCED
Имя D2DERR_PUSH_POP_UNBALANCED помогает сузить поиск: PUSH — сохранение состояния; POP — восстановление состояния; UNBALANCED — технический маркер «unbalanced». Эти части имени не заменяют документацию API, но позволяют проверить, что журнал и код относятся к одному и тому же условию.
Проверка причины
Применительно к D2DERR_PUSH_POP_UNBALANCED важно сохранить исходный контекст вызова: имя функции, параметры, состояние объекта и первый низкоуровневый статус. Применительно к D2DERR_PUSH_POP_UNBALANCED без этого одинаковый HRESULT может ошибочно связываться с разными причинами.
- При разборе D2DERR_PUSH_POP_UNBALANCED пересоздайте device-dependent resources после потери устройства вместо повторного использования старых объектов.
- При разборе D2DERR_PUSH_POP_UNBALANCED запишите метод Direct2D, параметры ресурса, factory и render target, которым принадлежат участвующие объекты.
- При разборе D2DERR_PUSH_POP_UNBALANCED проверьте баланс BeginDraw/EndDraw, Push/Pop, активные layer/clip и текущую target bitmap.
- При разборе D2DERR_PUSH_POP_UNBALANCED сверьте размеры текстур и поддерживаемые форматы с feature level и возможностями графического адаптера.
Как воспроизвести проблему
- Для D2DERR_PUSH_POP_UNBALANCED включите Direct2D debug layer и сохраните первое диагностическое сообщение перед HRESULT.
- Для D2DERR_PUSH_POP_UNBALANCED создайте минимальную сцену с теми же ресурсами и последовательностью вызовов.
- Для D2DERR_PUSH_POP_UNBALANCED проверяйте исправление как на аппаратном, так и на программном WARP-рендерере, если это допустимо.
Критерий успешного исправления
Применительно к D2DERR_PUSH_POP_UNBALANCED проверка исправления D2DERR_PUSH_POP_UNBALANCED должна включать успешный рабочий путь, предсказуемый отказ на некорректном входе и отсутствие новых предупреждений в журналах подсистемы Direct2D.
Ссылки по D2DERR_PUSH_POP_UNBALANCED
Нужно найти другой код? Найти другой код состояния или ошибки.