D3DHAL_CALLBACKS3 구조체(d3dhal.h)

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에서 설정하는 모든 비트에 대해 드라이버는 이 구조체의 해당 함수 포인터 멤버를 초기화해야 합니다. 이 멤버는 다음 플래그 중 하나 이상의 비트 OR일 수 있습니다.

플래그	의미
D3DHAL3_CB32_CLEAR2	DirectX 7.0 이상 버전에서는 사용되지 않습니다.
D3DHAL3_CB32_DRAWPRIMITIVES2	DrawPrimitives2member는 드라이버 구현 D3dDrawPrimitives2 콜백을 가리킵니다.
D3DHAL3_CB32_RESERVED	DirectX 7.0 이상 버전에서는 사용되지 않습니다.
D3DHAL3_CB32_VALIDATETEXTURESTAGESTATE	ValidateTextureStageStatemember는 드라이버 구현 D3dValidateTextureStageState 콜백을 가리킵니다.

Clear2

NULL로 설정해야 합니다. 이는 DirectX 7.0 이상에 더 이상 사용되지 않는 드라이버 제공 D3dClear2 콜백에 대한 포인터입니다. 대신 드라이버는 D3dDrawPrimitives2 구현에서 D3DDP2OP_CLEAR 명령 스트림 토큰에 응답해야 합니다.

lpvReserved

예약 필드를 지정하고 Windows 2000 이상 드라이버에서 NULL 로 설정해야 합니다.

ValidateTextureStageState

드라이버 제공 D3dValidateTextureStageState 콜백 또는 NULL을 가리킵니다. 멀티텍스처링을 지원하는 드라이버는 이 멤버가 가리키는 콜백을 구현해야 합니다.

DrawPrimitives2

드라이버 제공 D3dDrawPrimitives2 콜백을 가리킵니다. 드라이버는 이 멤버가 가리키는 콜백을 구현해야 합니다.

설명

드라이버는 이 구조를 할당하고 모든 멤버에 적절한 값을 설정합니다. 드라이버의 DdGetDriverInfo 함수는 GUID_D3DCallbacks3 GUID를 사용하여 해당 함수를 호출할 때 이 구조체에 대한 포인터를 반환합니다.

요구 사항

요구 사항	값
헤더	d3dhal.h(D3dhal.h 포함)

추가 정보

D3DDP2OP_CLEAR

D3DHAL_CALLBACKS

D3dDrawPrimitives2

D3dValidateTextureStageState

DdGetDriverInfo