DD_GETDRIVERSTATEDATA structure (ddrawint.h)
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;
} *PDD_GETDRIVERSTATEDATA, 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:
| Flag | Meaning |
|---|---|
| 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 |
|
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.
Requirements
| Requirement | Value |
|---|---|
| Header | ddrawint.h (include Winddi.h D3dhal.h, D3dtypes.h) |
See also
D3DDP2OP_CREATEQUERY
D3DDP2OP_ISSUEQUERY