Что означает код HRESULT 0x88990023 (D2DERR_ORIGINAL_TARGET_NOT_BOUND)?

 
Предыдущий Следующий
D2DERR_OUTSTANDING_BITMAP_REFERENCES D2DERR_INVALID_TARGET

D2DERR_ORIGINAL_TARGET_NOT_BOUND

D2DERR_ORIGINAL_TARGET_NOT_BOUND: интерпретация кода и контроль исправления

D2DERR_ORIGINAL_TARGET_NOT_BOUND имеет значение 0x88990023 (-2003238877 в знаковом 32-битном представлении). Операция не выполнена, поскольку исходный целевой объект сейчас не привязан как цель.

Для D2DERR_ORIGINAL_TARGET_NOT_BOUND старший бит HRESULT делает значение ошибкой. Константа D2DERR_ORIGINAL_TARGET_NOT_BOUND объявлена в winerror.h и относится к области «Direct2D/Direct3D и графический конвейер».

Где проходит граница ошибки

Для D2DERR_ORIGINAL_TARGET_NOT_BOUND код возникает на конкретной границе графического API: при создании ресурса, записи команд, отрисовке, представлении кадра или восстановлении устройства. Для D2DERR_ORIGINAL_TARGET_NOT_BOUND сначала нужно зафиксировать первый неуспешный вызов и сообщения debug layer, а не переинициализировать весь графический стек.

Для D2DERR_ORIGINAL_TARGET_NOT_BOUND одинаковый HRESULT может быть виден в нескольких слоях. Для D2DERR_ORIGINAL_TARGET_NOT_BOUND в журнале нужно отделить исходный возврат от последующих ошибок очистки, повторов и обёрток.

В имени D2DERR_ORIGINAL_TARGET_NOT_BOUND закодированы ориентиры для расследования: D2DERR — технический признак «d2derr»; ORIGINAL — технический признак «original»; TARGET — цель отрисовки; NOT — отсутствие требуемого условия; BOUND — технический признак «bound». Для D2DERR_ORIGINAL_TARGET_NOT_BOUND эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.

Что означает код: признаки в имени константы

Для D2DERR_ORIGINAL_TARGET_NOT_BOUND часть D2DERR относится к области «технический признак «d2derr»». При разборе D2DERR_ORIGINAL_TARGET_NOT_BOUND проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.

Для D2DERR_ORIGINAL_TARGET_NOT_BOUND часть ORIGINAL относится к области «технический признак «original»». При разборе D2DERR_ORIGINAL_TARGET_NOT_BOUND проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.

Компонент имени TARGET уточняет смысл D2DERR_ORIGINAL_TARGET_NOT_BOUND: речь идёт про цель отрисовки. Для D2DERR_ORIGINAL_TARGET_NOT_BOUND эту границу следует воспроизвести отдельно от последующей обработки ошибки.

Маркер NOT в D2DERR_ORIGINAL_TARGET_NOT_BOUND направляет проверку на отсутствие требуемого условия. Для D2DERR_ORIGINAL_TARGET_NOT_BOUND сопоставьте этот признак с фактическими параметрами первого неуспешного вызова.

Что сохранить до изменений

  • До повторной попытки по D2DERR_ORIGINAL_TARGET_NOT_BOUND нужно записать API-вызов, параметры, формат ресурса и состояние устройства.
  • Для воспроизводимого отчёта по D2DERR_ORIGINAL_TARGET_NOT_BOUND нужно проверить результат GetDeviceRemovedReason при признаках потери устройства.

Последовательность проверки

  1. Для D2DERR_ORIGINAL_TARGET_NOT_BOUND: Свести воспроизведение к одному ресурсу и одному графическому вызову; сохраните первый hresult и точное время результата.
  2. Для D2DERR_ORIGINAL_TARGET_NOT_BOUND: Проверить ограничения формата, bind flags, usage и состояния ресурса; отдельно отметьте изменение состояния объекта.
  3. Для D2DERR_ORIGINAL_TARGET_NOT_BOUND: Сравнить поведение с WARP или другим адаптером, не меняя остальные параметры; все остальные условия оставьте неизменными.
  4. Для D2DERR_ORIGINAL_TARGET_NOT_BOUND: Проверить переходы состояний и завершение команд перед повторным использованием; не удаляйте исходные данные до завершения сравнения.
  5. Для D2DERR_ORIGINAL_TARGET_NOT_BOUND: После исправления повторить resize, device recreation и длительный цикл кадров; повторите шаг на исправном контрольном примере.

Исправление и подтверждение результата

Корректирующее действие для D2DERR_ORIGINAL_TARGET_NOT_BOUND должно устранять условие «Операция не выполнена, поскольку исходный целевой объект сейчас не привязан как цель» на уровне Direct2D/Direct3D и графический конвейер. Для D2DERR_ORIGINAL_TARGET_NOT_BOUND простое подавление HRESULT, бесконечный повтор или очистка всех настроек не доказывают восстановление контракта.

Для D2DERR_ORIGINAL_TARGET_NOT_BOUND исправление считается подтверждённым, когда исходная операция проходит в том же окружении, отрицательный тест по-прежнему предсказуемо отклоняется, а журнал не содержит нового скрытого сбоя.

Технические ссылки

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