Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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. |