DD_GETDRIVERSTATEDATA structure

The DD_GETDRIVERSTATEDATA structure describes the state of the driver.

Syntax


typedef struct _DD_GETDRIVERSTATEDATA {
  DWORD   dwFlags;
  union {
    PDD_DIRECTDRAW_GLOBAL lpDD;
    DWORD_PTR             dwhContext;
  };
  LPDWORD lpdwStates;
  DWORD   dwLength;
  HRESULT ddRVal;
} DD_GETDRIVERSTATEDATA;

Members

dwFlags

Specifies the set of flags to indicate the data requested. This parameter can be set to one of the following flags:

FlagMeaning

D3DDEVINFOID_D3DTEXTUREMANAGER

Requests texture-management information performed by the Direct3D runtime in a D3DDEVINFO_TEXTUREMANAGER structure.

D3DDEVINFOID_TEXTUREMANAGER

Requests texture-management information performed by either the driver or the Direct3D runtime in a D3DDEVINFO_TEXTUREMANAGER structure.

D3DDEVINFOID_TEXTURING

Requests texture-activity information of the application in a D3DDEVINFO_TEXTURING structure.

D3DDEVINFOID_VCACHE

DirectX 8.1 versions only
Requests vertex-cache information in a D3DDEVINFO_VCACHE structure.

 

lpDD

Points to a DD_DIRECTDRAW_GLOBAL structure describing the device.

dwhContext

Specifies the ID of the context that information is being requested for.

lpdwStates

Points to the Direct3D driver state data to be filled in by the driver. If, for example, D3DDEVINFOID_VCACHE is specified in the dwFlags member, the driver points the lpdwStates member to a D3DDEVINFO_VCACHE structure that contains vertex-cache information.

dwLength

Specifies the length, in bytes, of the state data to be filled in by the driver.

ddRVal

Specifies the location where the driver writes the return value of the D3dGetDriverState callback. A return code of D3D_OK indicates success. For more information, see Return Codes for Direct3D Driver Callbacks.

Remarks

Applications can use the IDirect3DDevice7::GetInfo method and specify the D3DDEVINFOID_D3DTEXTUREMANAGER, D3DDEVINFOID_TEXTUREMANAGER, and D3DDEVINFOID_TEXTURING flags to retrieve texturing information. For more information about this method and the structures related to these flags, see the DirectX SDK documentation. The runtime then passes these flags to the driver.

DirectX 8.1 versions only. The Direct3D runtime specifies the D3DDEVINFOID_VCACHE flag in the dwFlags member to retrieve vertex-cache information from the driver specified at the lpDD member. The driver specifies this information in a D3DDEVINFO_VCACHE structure and returns it at the lpdwStates member.

DirectX 9.0 and later versions only. The Direct3D runtime asynchronously queries the driver for vertex-cache information by using the D3DDP2OP_CREATEQUERY and D3DDP2OP_ISSUEQUERY commands and the D3DQUERYTYPE_VCACHE query type in calls to the driver's D3dDrawPrimitives2 callback. For more information, see D3DDEVINFO_VCACHE.

Note  The D3DDEVINFOID_VCACHE flag is defined in d3dhal.h; the other flags that can be set in dwFlags are defined in d3dtypes.h.
 

Requirements

Header

Ddrawint.h (include Winddi.h D3dhal.h, and D3dtypes.h)

See also

D3DDEVINFO_VCACHE
D3DDP2OP_CREATEQUERY
D3DDP2OP_ISSUEQUERY
D3dDrawPrimitives2
D3dGetDriverState
DD_DIRECTDRAW_GLOBAL

 

 

Send comments about this topic to Microsoft

Show: