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

Статья
02/23/2024

D3DHAL_CALLBACKS3 является одной из нескольких структур обратного вызова, описывающих поддержку Direct3D, предоставляемую драйвером.

Синтаксис

typedef struct _D3DHAL_CALLBACKS3 {
  DWORD                                dwSize;
  DWORD                                dwFlags;
  LPD3DHAL_CLEAR2CB                    Clear2;
  LPVOID                               lpvReserved;
  LPD3DHAL_VALIDATETEXTURESTAGESTATECB ValidateTextureStageState;
  LPD3DHAL_DRAWPRIMITIVES2CB           DrawPrimitives2;
} D3DHAL_CALLBACKS3, *LPD3DHAL_CALLBACKS3;

Члены

dwSize

Задает размер этой структуры в байтах.

dwFlags

Указывает обратные вызовы, связанные с этой структурой, реализованные драйвером. Для каждого бита, который драйвер задает в dwFlags, драйвер должен инициализировать соответствующий элемент указателя функции этой структуры. Это может быть побитовое ИЛИ одного или нескольких следующих флагов:

Пометить	Значение
D3DHAL3_CB32_CLEAR2	Не используется в DirectX 7.0 и более поздних версиях.
D3DHAL3_CB32_DRAWPRIMITIVES2	DrawPrimitives2member указывает на реализованный драйвером обратный вызов D3dDrawPrimitives2 .
D3DHAL3_CB32_RESERVED	Не используется в DirectX 7.0 и более поздних версиях.
D3DHAL3_CB32_VALIDATETEXTURESTAGESTATE	ValidateTextureStageStatemember указывает на реализованный драйвером обратный вызов D3dValidateTextureStageState .

Clear2

Для параметра должно быть задано значение NULL. Это был указатель на предоставленный драйвером обратный вызов D3dClear2 , который больше не используется для DirectX 7.0 и более не используется. Вместо этого драйвер должен реагировать на маркер потока команды D3DDP2OP_CLEAR в реализации D3dDrawPrimitives2.

lpvReserved

Указывает зарезервированное поле и должно иметь значение NULL в драйвере Windows 2000 и более поздних версий.

ValidateTextureStageState

Указывает на предоставленный драйвером обратный вызов D3dValidateTextureStageState или NULL. Драйверы, поддерживающие многотекстурность, должны реализовывать обратный вызов, на который указывает этот элемент.

DrawPrimitives2

Указывает на предоставленный драйвером обратный вызов D3dDrawPrimitives2 . Драйвер должен реализовать обратный вызов, на который указывает этот элемент.

Драйвер выделяет эту структуру и задает соответствующие значения во всех элементах. Функция DdGetDriverInfo драйвера возвращает указатель на эту структуру при вызове этой функции с GUID_D3DCallbacks3 GUID.