Что означает код HRESULT 0x8899002C (D2DERR_PRINT_FORMAT_NOT_SUPPORTED)?

Код состояния / ошибки:

Категория:

Имя константы:

Источник:

Подсистема (Facility):

Операционная система:

Описание:

Не удалось создать управление печатью: Direct2D не поддерживает ни один из целевых форматов пакета принтера.

Предыдущий	Следующий
D2DERR_PRINT_JOB_CLOSED	D2DERR_TOO_MANY_TRANSFORM_INPUTS

D2DERR_PRINT_FORMAT_NOT_SUPPORTED

Как расследовать HRESULT D2DERR_PRINT_FORMAT_NOT_SUPPORTED

Код D2DERR_PRINT_FORMAT_NOT_SUPPORTED, числовое значение 0x8899002C, фиксирует конкретный результат операции. Не удалось создать управление печатью: Direct2D не поддерживает ни один из целевых форматов пакета принтера.

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

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

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

Для D2DERR_PRINT_FORMAT_NOT_SUPPORTED не следует начинать с очистки состояния или переустановки компонента. Для D2DERR_PRINT_FORMAT_NOT_SUPPORTED сначала необходимо привязать результат к одному вызову, объекту и поколению его состояния.

В имени D2DERR_PRINT_FORMAT_NOT_SUPPORTED закодированы ориентиры для расследования: D2DERR — технический признак «d2derr»; PRINT — технический признак «print»; FORMAT — формат данных; NOT — отсутствие требуемого условия; SUPPORTED — поддерживаемая возможность. Для D2DERR_PRINT_FORMAT_NOT_SUPPORTED эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.

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

Маркер D2DERR в D2DERR_PRINT_FORMAT_NOT_SUPPORTED направляет проверку на технический признак «d2derr». Для D2DERR_PRINT_FORMAT_NOT_SUPPORTED сопоставьте этот признак с фактическими параметрами первого неуспешного вызова.

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

Для D2DERR_PRINT_FORMAT_NOT_SUPPORTED часть FORMAT относится к области «формат данных». При разборе D2DERR_PRINT_FORMAT_NOT_SUPPORTED проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.

При разборе D2DERR_PRINT_FORMAT_NOT_SUPPORTED обозначение NOT связывает код с темой «отсутствие требуемого условия». До повторной проверки D2DERR_PRINT_FORMAT_NOT_SUPPORTED сохраните входные данные без нормализации.

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

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

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

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

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

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

Для D2DERR_PRINT_FORMAT_NOT_SUPPORTED зафиксируйте результат до и после изменения одними и теми же средствами. Для D2DERR_PRINT_FORMAT_NOT_SUPPORTED сравнивайте не только HRESULT, но и конечное состояние объекта, побочные эффекты и события подсистемы.

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

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