D3DHAL_CALLBACKS3 構造体 (d3dhal.h)

D3DHAL_CALLBACKS3は、ドライバーによって提供される Direct3D サポートを記述するいくつかのコールバック構造の 1 つです。

構文

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 でドライバーが設定するすべてのビットについて、ドライバーは、この構造体の対応する関数ポインター メンバーを初期化する必要があります。 このメンバーには、次の 1 つ以上のフラグのビットごとの OR を指定できます。

Clear2

NULL に設定する必要があります。 これは、DirectX 7.0 以降では使用されなくなったドライバー提供の D3dClear2 コールバックへのポインターでした。 代わりに、ドライバーは D3dDrawPrimitives2 の実装でD3DDP2OP_CLEAR コマンド ストリーム トークンに応答する必要があります。

lpvReserved

予約済みフィールドを指定し、Windows 2000 以降のドライバーで NULL に設定する必要があります。

ValidateTextureStageState

ドライバーが提供する D3dValidateTextureStageState コールバック ( NULL) を指します。 マルチテクスチャリングをサポートするドライバーは、このメンバーが指すコールバックを実装する必要があります。

DrawPrimitives2

ドライバーが提供する D3dDrawPrimitives2 コールバックを 指します。 ドライバーは、このメンバーが指すコールバックを実装する必要があります。

注釈

ドライバーは、この構造体を割り当て、すべてのメンバーに適切な値を設定します。 ドライバーの DdGetDriverInfo 関数は、その関数がGUID_D3DCallbacks3 GUID で呼び出されたときに、この構造体へのポインターを返します。

要件

こちらもご覧ください

D3DDP2OP_CLEAR

D3DHAL_CALLBACKS

D3dDrawPrimitives2

D3dValidateTextureStageState

DdGetDriverInfo