| Предыдущий | Следующий |
| D2DERR_MAX_TEXTURE_SIZE_EXCEEDED | D2DERR_BAD_NUMBER |
D2DERR_UNSUPPORTED_VERSION
Что означает D2DERR_UNSUPPORTED_VERSION и где искать причину
Windows возвращает D2DERR_UNSUPPORTED_VERSION (0x88990010), когда выполняется следующее условие: Запрошенная версия Direct2D не поддерживается.
Для D2DERR_UNSUPPORTED_VERSION старший бит HRESULT делает значение ошибкой. Константа D2DERR_UNSUPPORTED_VERSION объявлена в winerror.h и относится к области «Direct2D/Direct3D и графический конвейер».
Где проходит граница ошибки
Для D2DERR_UNSUPPORTED_VERSION код возникает на конкретной границе графического API: при создании ресурса, записи команд, отрисовке, представлении кадра или восстановлении устройства. Для D2DERR_UNSUPPORTED_VERSION сначала нужно зафиксировать первый неуспешный вызов и сообщения debug layer, а не переинициализировать весь графический стек.
Для D2DERR_UNSUPPORTED_VERSION само имя кода не доказывает первопричину. Для D2DERR_UNSUPPORTED_VERSION оно указывает, на каком контракте подсистема обнаружила нарушение; первичным считается первый вызов, который вернул HRESULT.
В имени D2DERR_UNSUPPORTED_VERSION закодированы ориентиры для расследования: D2DERR — технический признак «d2derr»; UNSUPPORTED — неподдерживаемая возможность; VERSION — версия. Для D2DERR_UNSUPPORTED_VERSION эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.
Что означает код: признаки в имени константы
Для D2DERR_UNSUPPORTED_VERSION часть D2DERR относится к области «технический признак «d2derr»». При разборе D2DERR_UNSUPPORTED_VERSION проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.
Маркер UNSUPPORTED в D2DERR_UNSUPPORTED_VERSION направляет проверку на неподдерживаемая возможность. Для D2DERR_UNSUPPORTED_VERSION сопоставьте этот признак с фактическими параметрами первого неуспешного вызова.
Для D2DERR_UNSUPPORTED_VERSION часть VERSION относится к области «версия». При разборе D2DERR_UNSUPPORTED_VERSION проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.
Для D2DERR_UNSUPPORTED_VERSION в техническом контексте особенно важны: IID, отладочный слой Direct3D. При расследовании D2DERR_UNSUPPORTED_VERSION их следует проверять как связанные части одной операции, а не как независимые симптомы.
Что сохранить до изменений
- Для воспроизводимого отчёта по
D2DERR_UNSUPPORTED_VERSIONнужно записать API-вызов, параметры, формат ресурса и состояние устройства. - В первичном журнале по
D2DERR_UNSUPPORTED_VERSIONнужно проверить результат GetDeviceRemovedReason при признаках потери устройства.
Последовательность проверки
- Для
D2DERR_UNSUPPORTED_VERSION: Свести воспроизведение к одному ресурсу и одному графическому вызову; не удаляйте исходные данные до завершения сравнения. - Для
D2DERR_UNSUPPORTED_VERSION: Проверить ограничения формата, bind flags, usage и состояния ресурса; повторите шаг на исправном контрольном примере. - Для
D2DERR_UNSUPPORTED_VERSION: Сравнить поведение с WARP или другим адаптером, не меняя остальные параметры; сохраните первый hresult и точное время результата. - Для
D2DERR_UNSUPPORTED_VERSION: Проверить переходы состояний и завершение команд перед повторным использованием; отдельно отметьте изменение состояния объекта. - Для
D2DERR_UNSUPPORTED_VERSION: После исправления повторить resize, device recreation и длительный цикл кадров; все остальные условия оставьте неизменными.
Исправление и подтверждение результата
Корректирующее действие для D2DERR_UNSUPPORTED_VERSION должно устранять условие «Запрошенная версия Direct2D не поддерживается» на уровне IID. Для D2DERR_UNSUPPORTED_VERSION простое подавление HRESULT, бесконечный повтор или очистка всех настроек не доказывают восстановление контракта.
Для D2DERR_UNSUPPORTED_VERSION зафиксируйте результат до и после изменения одними и теми же средствами. Для D2DERR_UNSUPPORTED_VERSION сравнивайте не только HRESULT, но и конечное состояние объекта, побочные эффекты и события подсистемы.
Технические ссылки
- Microsoft: Direct2D коды ошибок — D2DERR_UNSUPPORTED_VERSION
- Microsoft: Direct2D API обзор — D2DERR_UNSUPPORTED_VERSION
- Microsoft: Microsoft: Direct2D devices and device contexts — D2DERR_UNSUPPORTED_VERSION
- Microsoft Open Specifications: значения HRESULT — D2DERR_UNSUPPORTED_VERSION
- Документация Direct2D — D2DERR_UNSUPPORTED_VERSION
Нужно найти другой код? Найти другой код состояния или ошибки.
