D3DHAL_CALLBACKS3
TOC
Collapse the table of content
Expand the table of content

D3DHAL_CALLBACKS3 structure

D3DHAL_CALLBACKS3 is one of several callback structures that describe the Direct3D support provided by the driver.

Syntax


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

Members

dwSize

Specifies the size in bytes of this structure.

dwFlags

Indicates the callbacks associated with this structure that the driver has implemented. For every bit the driver sets in dwFlags, the driver must initialize the corresponding function pointer member of this structure. This member can be the bitwise-OR of one or more of the following flags:

FlagMeaning

D3DHAL3_CB32_CLEAR2

Not used in DirectX 7.0 and later versions.

D3DHAL3_CB32_DRAWPRIMITIVES2

The DrawPrimitives2 member points to a driver-implemented D3dDrawPrimitives2 callback.

D3DHAL3_CB32_RESERVED

Not used in DirectX 7.0 and later versions.

D3DHAL3_CB32_VALIDATETEXTURESTAGESTATE

The ValidateTextureStageState member points to a driver-implemented D3dValidateTextureStageState callback.

 

Clear2

Must be set to NULL. This was a pointer to the driver-supplied D3dClear2 callback that is no longer used for DirectX 7.0 and beyond. Instead the driver should respond to the D3DDP2OP_CLEAR command stream token in its implementation of D3dDrawPrimitives2.

lpvReserved

Specifies a reserved field and must be set to NULL in a Windows 2000 and later driver.

ValidateTextureStageState

Points to the driver-supplied D3dValidateTextureStageState callback, or NULL. Drivers that support multitexturing must implement the callback that this member points to.

DrawPrimitives2

Points to the driver-supplied D3dDrawPrimitives2 callback. A driver must implement the callback that this member points to.

Remarks

The driver allocates this structure and sets appropriate values in all members. The driver's DdGetDriverInfo function returns a pointer to this structure when that function is called with the GUID_D3DCallbacks3 GUID.

Requirements

Header

D3dhal.h (include D3dhal.h)

See also

D3DDP2OP_CLEAR
D3dDrawPrimitives2
D3DHAL_CALLBACKS
D3dValidateTextureStageState
DdGetDriverInfo

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft