структура DD_GETFORMATDATA (d3dhal.h)

  • Статья

Только DirectX 8.0 и более поздних версий.

DD_GETFORMATDATA — это структура данных, на которую указывает поле lpvDataDD_GETDRIVERINFODATA для запросов DD_GETDRIVERINFO2DATA с типом D3DGDI2_TYPE_GETFORMAT.

Синтаксис

typedef struct _DD_GETFORMATDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  DWORD                 dwFormatIndex;
  DDPIXELFORMAT         format;
} DD_GETFORMATDATA;

Члены

gdi2

Задает структуру DD_GETDRIVERINFO2DATA , содержащую данные GetDriverInfo2 .

dwFormatIndex

Задает индекс возвращаемого формата пикселей.

format

Получает фактический формат пикселей в структуре DDPIXELFORMAT .

Комментарии

Среда выполнения определяет возвращаемый формат с целочисленным индексом, значение которого в диапазоне от нуля до одного меньше, чем число поддерживаемых форматов, сообщаемых ранее драйвером. Способ сопоставления этих индексов с фактическими форматами остается за драйвером. Однако каждый индекс должен уникально сопоставляться с одним поддерживаемым форматом. Порядок, в котором форматы передаются, не имеет значения.

При обработке этого запроса GetDriverInfo2 драйвер должен прочитать dwFormatIndex и сопоставить его с одним из поддерживаемых форматов (возможно, используя dwFormatIndex в качестве индекса в массив структур DDPIXELFORMAT), а затем скопировать этот формат в поле формата поля DD_GETFORMATDATA. Среда выполнения гарантирует, что она передает индекс только драйверу, который находится в диапазоне от нуля до единицы меньше, чем число форматов surface, сообщаемых драйвером. Диапазон индекса должен быть проверен в сборке драйвера отладки.

Только Для DirectX 9.0 и более поздних версий.Во входных данных версия среды выполнения DirectX, используемая приложением, указывается в элементе dwSize структуры DDPIXELFORMAT в формате. Этот член dwSize имеет значение DD_RUNTIME_VERSION, что 0x00000900 для DirectX 9.0.

Требования

Требование Значение
Заголовок d3dhal.h (включая D3dhal.h)

См. также раздел

DDPIXELFORMAT

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA