d3dhal.h header

This header is used by display. For more information, see:

d3dhal.h contains the following programming interfaces:

Callback functions

 
LPD3DHAL_CONTEXTCREATECB

The D3dContextCreate function creates a context.
LPD3DHAL_CONTEXTDESTROYCB

The D3dContextDestroy function deletes the specified context.
LPD3DHAL_DRAWPRIMITIVES2CB

The D3dDrawPrimitives2 function renders primitives and returns the updated render state.
LPD3DHAL_VALIDATETEXTURESTAGESTATECB

The D3dValidateTextureStageState function returns the number of passes where the hardware can perform the blending operations specified in the current state.

Structures

 
D3DDEVICEDESC_V1

Obsolete in DirectX 8.0 and later versions; see Remarks. The D3DDEVICEDESC_V1 structure describes the 3D capabilities of a device.
D3DDEVICEDESC_V2

The D3DDEVICEDESC_V2 structure contains fields that are already reported in the D3DHAL_D3DEXTENDEDCAPS structure when responding to the GUID_D3DExtendedCaps GUID in DdGetDriverInfo.
D3DDEVICEDESC_V3

The D3DDEVICEDESC_V3 structure contains fields that are already reported in the D3DHAL_D3DEXTENDEDCAPS structure when responding to the GUID_D3DExtendedCaps GUID in DdGetDriverInfo.
D3DHAL_CALLBACKS

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

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

The D3DHAL_CLIPPEDTRIANGLEFAN structure is used by the D3dDrawPrimitives2 callback function to render clipped triangle fans.
D3DHAL_CONTEXTCREATEDATA

The D3DHAL_CONTEXTCREATEDATA structure contains all of the information that the D3dContextCreate function requires to create a new context.
D3DHAL_CONTEXTDESTROYDATA

The D3DHAL_CONTEXTDESTROYDATA structure contains the information that the D3dContextDestroy function requires to delete a context.
D3DHAL_D3DEXTENDEDCAPS

D3DHAL_D3DEXTENDEDCAPS describes additional 3D capabilities of the driver.
D3DHAL_DP2ADDDIRTYBOX

DirectX 8.1 and later versions only. D3DHAL_DP2ADDDIRTYBOX is used to specify that a portion of a 3D resource--a volume texture--was dirtied in system memory. Therefore, this volume must be reloaded into video memory before being used.
D3DHAL_DP2ADDDIRTYRECT

DirectX 8.1 and later versions only. D3DHAL_DP2ADDDIRTYRECT is used to specify that a portion of a 2D resource--a 2D texture or cube texture--was dirtied in system memory. Therefore, this 2D texture must be reloaded into video memory before being used.
D3DHAL_DP2BLT

DirectX 9.0 and later versions only. D3DHAL_DP2BLT is used for two dimensional surface blts when D3dDrawPrimitives2 responds to the D3DDP2OP_BLT command token.
D3DHAL_DP2BUFFERBLT

DirectX 8.0 and later versions only. D3DHAL_DP2BUFFERBLT is used for vertex or index buffer blts when D3dDrawPrimitives2 responds to the D3DDP2OP_BUFFERBLT command token.
D3DHAL_DP2CLEAR

D3DHAL_DP2CLEAR contains all of the information that the driver needs to perform hardware-assisted clearing on the rendering target, depth buffer or stencil buffer.
D3DHAL_DP2COLORFILL

DirectX 9.0 and later versions only. D3DHAL_DP2COLORFILL is used for color-fill operations when D3dDrawPrimitives2 responds to the D3DDP2OP_COLORFILL command token.
D3DHAL_DP2COMMAND

One or more D3DHAL_DP2COMMAND structures are parsed from the command buffer by the D3dDrawPrimitives2 callback, which uses the information it receives to draw one or more primitives.
D3DHAL_DP2CREATELIGHT

The D3DHAL_DP2CREATELIGHT structure is used to create a light for D3dDrawPrimitives2.
D3DHAL_DP2CREATEPIXELSHADER

DirectX 8.0 and later versions only. The D3DHAL_DP2CREATEPIXELSHADER structure is used to create a pixel shader when a D3DDP2OP_CREATEPIXELSHADER opcode is received by D3dDrawPrimitives2.
D3DHAL_DP2CREATEQUERY

The D3DHAL_DP2CREATEQUERY structure is used by the D3dDrawPrimitives2 callback function to create resources for queries.
D3DHAL_DP2CREATEVERTEXSHADER

DirectX 8.0 and later versions only. The D3DHAL_DP2CRED3dDrawPrimitives2ATEVERTEXSHADER structure is used to create a vertex shader when a D3DDP2OP_CREATEVERTEXSHADER opcode is received by .
D3DHAL_DP2CREATEVERTEXSHADERDECL

DirectX 9.0 and later versions only. The D3DHAL_DP2CREATEVERTEXSHADERDECL structure is used to create a vertex shader declaration when a D3DDP2OP_CREATEVERTEXSHADERDECL opcode is received by D3dDrawPrimitives2.
D3DHAL_DP2CREATEVERTEXSHADERFUNC

DirectX 9.0 and later versions only. The D3DHAL_DP2CREATEVERTEXSHADERFUNC structure is used to create a vertex shader code object when a D3DDP2OP_CREATEVERTEXSHADERFUNC opcode is received by D3dDrawPrimitives2.
D3DHAL_DP2DELETEQUERY

The D3DHAL_DP2DELETEQUERY structure is used by the D3dDrawPrimitives2 callback function to release resources for queries.
D3DHAL_DP2DRAWINDEXEDPRIMITIVE

The D3DHAL_DP2DRAWINDEXEDPRIMITIVE structure is used by the D3dDrawPrimitives2 callback function to render a primitive using vertex indices.
D3DHAL_DP2DRAWINDEXEDPRIMITIVE2

The D3DHAL_DP2DRAWINDEXEDPRIMITIVE2 structure is used by the D3dDrawPrimitives2 callback function to render a primitive using vertex indices.
D3DHAL_DP2DRAWPRIMITIVE

DirectX 8.0 and later versions only. D3DHAL_DRAWPRIMITIVE is parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_DRAWPRIMITIVE, and is used to render a primitive.
D3DHAL_DP2DRAWPRIMITIVE2

DirectX 8.0 and later versions only. D3DHAL_DRAWPRIMITIVE2 is parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_DRAWPRIMITIVE2, and is used to render a primitive.
D3DHAL_DP2DRAWRECTPATCH

The D3DHAL_DP2DRAWRECTPATCH structure is used by the D3dDrawPrimitives2 callback function to render a rectangular patch.
D3DHAL_DP2DRAWTRIPATCH

The D3DHAL_DP2DRAWTRIPATCH structure is used by the D3dDrawPrimitives2 callback function to render a triangular patch.
D3DHAL_DP2EXT

The D3DHAL_DP2EXT structure's use has yet to be defined.
D3DHAL_DP2GENERATEMIPSUBLEVELS

DirectX 9.0 and later versions only. The D3DHAL_DP2GENERATEMIPSUBLEVELS structure is used to inform the driver to automatically generate the sublevels of a given MIP-map texture using a given filter type.
D3DHAL_DP2INDEXEDLINELIST

D3DHAL_DP2INDEXEDLINELIST is parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_INDEXEDLINELIST, and is used to render the lines using vertex indices.
D3DHAL_DP2INDEXEDLINESTRIP

D3DHAL_DP2INDEXEDLINESTRIP is parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_INDEXEDLINESTRIP, and is used to render a sequence of connected line segments using vertex indices.
D3DHAL_DP2INDEXEDTRIANGLEFAN

D3DHAL_DP2INDEXEDTRIANGLEFAN is parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_INDEXEDTRIANGLEFAN, and is used to render a sequence of connected triangles using vertex indices. All of the triangles share a common vertex.
D3DHAL_DP2INDEXEDTRIANGLELIST

One or more D3DHAL_DP2INDEXEDTRIANGLELIST structures are parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_INDEXEDTRIANGLELIST, and are used to render a sequence of unconnected triangles using vertex indices.
D3DHAL_DP2INDEXEDTRIANGLELIST2

One or more D3DHAL_DP2INDEXEDTRIANGLELIST2 structures are parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_INDEXEDTRIANGLELIST2, and are used to render a sequence of unconnected triangles using vertex indices.
D3DHAL_DP2INDEXEDTRIANGLESTRIP

One or more D3DHAL_DP2INDEXEDTRIANGLESTRIP structures are parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_INDEXEDTRIANGLESTRIP, and are used to render strips of connected triangles using vertex indices.
D3DHAL_DP2ISSUEQUERY

The D3DHAL_DP2ISSUEQUERY structure is used by the D3dDrawPrimitives2 callback function to query for various types of information.
D3DHAL_DP2LINELIST

One D3DHAL_DP2LINELIST structure is parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_LINELIST, and is used to render unconnected line segments.
D3DHAL_DP2LINESTRIP

One D3DHAL_DP2LINESTRIP structure is parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_LINESTRIP, and is used to render the specified connected line segments.
D3DHAL_DP2MULTIPLYTRANSFORM

DirectX 8.0 and later versions only. The D3DHAL_DP2MULTIPLYTRANSFORM structure is used to modify the transform matrix for D3dDrawPrimitives2.
D3DHAL_DP2PIXELSHADER

DirectX 8.0 and later versions only. The D3DHAL_DP2PIXELSHADER structure is used to set the current pixel shader, or delete a pixel shader, depending on the opcode received (D3DDP2OP_SETPIXELSHADER or D3DDP2OP_DELETEPIXELSHADER) by D3dDrawPrimitives2.
D3DHAL_DP2POINTS

One or more D3DHAL_DP2POINTS structures are parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_POINTS, and are used to render the specified points.
D3DHAL_DP2RENDERSTATE

One or more D3DHAL_DP2RENDERSTATE structures are parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_RENDERSTATE, and are used to set the appropriate render state.
D3DHAL_DP2RESPONSE

The D3DHAL_DP2RESPONSE structure is returned by the D3dDrawPrimitives2 callback and specifies the availability of responses to previously issued queries.
D3DHAL_DP2RESPONSEQUERY

The D3DHAL_DP2RESPONSEQUERY structure is returned by the D3dDrawPrimitives2 callback and specifies the availability of responses to previously issued queries.
D3DHAL_DP2SETCLIPPLANE

The D3DHAL_SETCLIPPLANE structure allows user defined clip planes to be used in world space.
D3DHAL_DP2SETDEPTHSTENCIL

DirectX 9.0 and later versions only. The D3DHAL_DP2SETDEPTHSTENCIL structure is used to map a new depth buffer in the driver's current context when the D3DDP2OP_SETDEPTHSTENCIL operation code is received by D3dDrawPrimitives2.
D3DHAL_DP2SETINDICES

DirectX 8.0 and later versions only. The D3DHAL_DP2SETINDICES structure is used to set the current index buffer for D3dDrawPrimitives2.
D3DHAL_DP2SETLIGHT

The D3DHAL_DP2SETLIGHT structure allows lights to be set for D3dDrawPrimitives2.
D3DHAL_DP2SETPALETTE

The D3DHAL_DP2SETPALETTE structure is used to associate a palette with a texture when a driver responds to D3DDP2OP_SETPALETTE in D3dDrawPrimitives2.
D3DHAL_DP2SETPIXELSHADERCONST

DirectX 8.0 and later versions only. The D3DHAL_DP2SETPIXELSHADERCONST structure is used to set one or more of the pixel shader constant registers when the D3DDP2OP_SETPIXELSHADERCONST opcode is received by D3dDrawPrimitives2.
D3DHAL_DP2SETPRIORITY

The D3DHAL_DP2SETPRIORITY structure is used to inform the driver of the priority of the texture specified by the handle dwDDDestSurface.
D3DHAL_DP2SETRENDERTARGET

The D3DHAL_DP2SETRENDERTARGET structure is used with the D3DDP2OP_SETRENDERTARGET opcode to map a new rendering target surface and depth buffer in the current context.
D3DHAL_DP2SETRENDERTARGET2

The D3DHAL_DP2SETRENDERTARGET2 structure is used with the D3DDP2OP_SETRENDERTARGET2 opcode to map a portion of a rendering target surface and depth buffer in the current context.
D3DHAL_DP2SETSTREAMSOURCE

DirectX 8.0 and later versions only. The D3DHAL_DP2SETSTREAMSOURCE structure is used to bind a vertex stream source to a vertex buffer for D3dDrawPrimitives2.
D3DHAL_DP2SETSTREAMSOURCE2

DirectX 9.0 and later versions only. The D3DHAL_DP2SETSTREAMSOURCE2 structure is used to bind a portion of a vertex stream source to a vertex buffer for D3dDrawPrimitives2.
D3DHAL_DP2SETSTREAMSOURCEFREQ

DirectX 9.0 and later versions only. The D3DHAL_DP2SETSTREAMSOURCEFREQ structure is used to set the frequency divisor of a stream source that is bound to a vertex buffer for D3dDrawPrimitives2.
D3DHAL_DP2SETSTREAMSOURCEUM

DirectX 8.0 and later versions only. The D3DHAL_DP2SETSTREAMSOURCEUM structure is used to bind a vertex stream source to a user memory buffer for D3dDrawPrimitives2.
D3DHAL_DP2SETTEXLOD

The D3DHAL_DP2SETTEXLOD structure is used to set the level of detail (LOD) for MIP maps when the D3DDP2OP_SETTEXLOD command is sent to D3dDrawPrimitives2.
D3DHAL_DP2SETTRANSFORM

D3DHAL_DP2SETTRANSFORM structure is used to specify the transform state and matrix for D3dDrawPrimitives2.
D3DHAL_DP2SETVERTEXSHADERCONST

DirectX 8.0 and later versions only. The D3DHAL_DP2SETVERTEXSHADERCONST structure is used to set one or more of the vertex shader constant registers when the D3DDP2OP_SETVERTEXSHADERCONST opcode is received by D3dDrawPrimitives2.
D3DHAL_DP2STARTVERTEX

A D3DHAL_DP2STARTVERTEX structure follows certain D3DHAL_DP2COMMAND structures in the command buffer, and indicates the offset in the vertex buffer for the first vertex to use in D3dDrawPrimitives2.
D3DHAL_DP2STATESET

The D3DHAL_DP2STATESET structure is used to inform the driver about stateset operations to perform.
D3DHAL_DP2SURFACEBLT

DirectX 9.0 and later versions only. D3DHAL_DP2SURFACEBLT is used for two dimensional system memory to video memory surface blts when D3dDrawPrimitives2 responds to the D3DDP2OP_SURFACEBLT command token.
D3DHAL_DP2TEXBLT

The D3DHAL_DP2TEXBLT structure is used for texture blts when D3dDrawPrimitives2 responds to the D3DDP2OP_TEXBLT command token.
D3DHAL_DP2TEXTURESTAGESTATE

One or more D3DHAL_DP2TEXTURESTAGESTATE structures are parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_TEXTURESTAGESTATE, and are used to set the appropriate texture stage state.
D3DHAL_DP2TRIANGLEFAN

One D3DHAL_DP2TRIANGLEFAN structure is parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_TRIANGLEFAN, and is used to render a triangle fan.
D3DHAL_DP2TRIANGLEFAN_IMM

One D3DHAL_DP2TRIANGLEFAN_IMM structure is parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_TRIANGLEFAN_IMM, and is used to render a triangle fan.
D3DHAL_DP2TRIANGLELIST

One D3DHAL_DP2TRIANGLELIST structure is parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_TRIANGLELIST, and is used to render the specified unconnected triangles.
D3DHAL_DP2TRIANGLESTRIP

One D3DHAL_DP2TRIANGLESTRIP structure is parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_TRIANGLESTRIP, and is used to render the specified connected triangle strip.
D3DHAL_DP2UPDATEPALETTE

The D3DHAL_DP2UPDATEPALETTE structure alters the palette that is used for palletized textures.
D3DHAL_DP2VERTEXSHADER

DirectX 8.0 and later versions only. The D3DHAL_DP2VERTEXSHADER structure sets the current vertex shader, or deletes a vertex shader, depending on the opcode received (D3DDP2OP_SETVERTEXSHADER or D3DDP2OP_DELETEVERTEXSHADER) by D3dDrawPrimitives2.
D3DHAL_DP2VIEWPORTINFO

The D3DHAL_DP2VIEWPORTINFO structure is used to inform guard-band aware drivers of the view clipping rectangle. The clipping rectangle is specified by the members dwX, dwY, dwWidth and dwHeight.
D3DHAL_DP2VOLUMEBLT

DirectX 8.0 and later versions only. The D3DHAL_DP2VOLUMEBLT structure is used for volume texture blts when D3dDrawPrimitives2 responds to the D3DDP2OP_VOLUMEBLT command token.
D3DHAL_DP2WINFO

The D3DHAL_DP2WINFO structure is used to inform the driver of the w-range to be used for w-buffering.
D3DHAL_DP2ZRANGE

The D3DHAL_DP2ZRANGE structure specifies z-range minimum and maximum in D3dDrawPrimitives2.
D3DHAL_DRAWPRIMITIVES2DATA

The D3DHAL_DRAWPRIMITIVES2DATA structure contains the information required by the D3dDrawPrimitives2 function to render primitives.
D3DHAL_GLOBALDRIVERDATA

The D3DHAL_GLOBALDRIVERDATA structure specifies the 3D capabilities of the driver and its device.
D3DHAL_VALIDATETEXTURESTAGESTATEDATA

The D3DHAL_VALIDATETEXTURESTAGESTATEDATA structure contains the information required for the driver to determine and return its ability to support multitexturing using the current state.
DD_DEFERRED_AGP_AWARE_DATA

DirectX 8.0 and later versions and NT-based operating systems only. DD_DEFERRED_AGP_AWARE_DATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for D3DGDI2_TYPE_DEFERRED_AGP_AWARE notifications.
DD_DXVERSION

DirectX 8.0 and later versions only. DD_DXVERSION describes the current DirectX runtime version.
DD_FREE_DEFERRED_AGP_DATA

DirectX 8.0 and later versions and NT-based operating systems only. DD_FREE_DEFERRED_AGP_DATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for D3DGDI2_TYPE_DEFER_AGP_FREES and D3DGDI2_TYPE_FREE_DEFERRED_AGP notifications.
DD_GETADAPTERGROUPDATA

DirectX 9.0 and later versions only. DD_GETADAPTERGROUPDATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for DD_GETDRIVERINFO2DATA queries with the type D3DGDI2_TYPE_GETADAPTERGROUP.
DD_GETD3DQUERYCOUNTDATA

DirectX 9.0 and later versions only. DD_GETD3DQUERYCOUNTDATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for DD_GETDRIVERINFO2DATA queries with the type D3DGDI2_TYPE_GETD3DQUERYCOUNT.
DD_GETD3DQUERYDATA

DirectX 9.0 and later versions only. DD_GETD3DQUERYDATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for DD_GETDRIVERINFO2DATA queries with the type D3DGDI2_TYPE_GETD3DQUERY.
DD_GETDDIVERSIONDATA

DirectX 9.0 and later versions only. DD_GETDDIVERSIONDATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for DD_GETDRIVERINFO2DATA queries with the type D3DGDI2_TYPE_GETDDIVERSION.
DD_GETDRIVERINFO2DATA

DirectX 8.0 and later versions only. DD_GETDRIVERINFO2DATA is passed in the lpvData member of the DD_GETDRIVERINFODATA structure when GUID_GetDriverInfo2 is specified in the guidInfo member of DD_GETDRIVERINFODATA in a DdGetDriverInfo call.
DD_GETEXTENDEDMODECOUNTDATA

DirectX 9.0 and later versions only. DD_GETEXTENDEDMODECOUNTDATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for DD_GETDRIVERINFO2DATA queries with the type D3DGDI2_TYPE_GETEXTENDEDMODECOUNT.
DD_GETEXTENDEDMODEDATA

DirectX 9.0 and later versions only. DD_GETEXTENDEDMODEDATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for DD_GETDRIVERINFO2DATA queries with the type D3DGDI2_TYPE_GETEXTENDEDMODE.
DD_GETFORMATCOUNTDATA

DirectX 8.0 and later versions only. DD_GETFORMATCOUNTDATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for DD_GETDRIVERINFO2DATA queries with the type D3DGDI2_TYPE_GETFORMATCOUNT.
DD_GETFORMATDATA

DD_GETFORMATDATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for DD_GETDRIVERINFO2DATA queries with the type D3DGDI2_TYPE_GETFORMAT.
DD_MULTISAMPLEQUALITYLEVELSDATA

DirectX 9.0 and later versions only. DD_MULTISAMPLEQUALITYLEVELSDATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for DD_GETDRIVERINFO2DATA queries with the type D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS.

Enumerations

 
D3DHAL_DP2OPERATION

The D3DHAL_DP2OPERATION enumerated type specifies the D3dDrawPrimitives2 operation in the bCommand member of the D3DHAL_DP2COMMAND structure.