D3DHAL_DP2ISSUEQUERY structure (d3dhal.h)

DirectX 9.0 and later versions only.

One or more D3DHAL_DP2ISSUEQUERY structures are parsed from the command buffer by the D3dDrawPrimitives2 callback when the D3DHAL_DP2COMMAND structure's bCommand member is set to D3DDP2OP_ISSUEQUERY, and are used to query for various types of information.

Syntax

typedef struct _D3DHAL_DP2ISSUEQUERY {
  DWORD dwQueryID;
  DWORD dwFlags;
} D3DHAL_DP2ISSUEQUERY;

Members

dwQueryID

Identifies the query for which the driver asynchronously provides information.

dwFlags

Specifies the state of the query. This member can contain one or more of the following flags:

Value Meaning
D3DISSUE_BEGIN (1 << 1) Starts building the query. The runtime does not request query data while in this state.
D3DISSUE_END (1 << 0) Transitions the state to subsignaled. Results of the query are not available until the state transitions to signaled.

The driver can ignore query requests with dwFlags set to 0.

Remarks

The runtime uses D3DHAL_DP2ISSUEQUERY to identify each query that the driver must process. The driver's D3dDrawPrimitives2 callback must process wPrimitiveCount D3DHAL_DP2ISSUEQUERY structures from the command buffer. The value of wPrimitiveCount is specified in the D3DHAL_DP2COMMAND structure. The driver parses these structures and retrieves information associated with the queries that they represent.

Requirements

Requirement Value
Header d3dhal.h (include D3dhal.h)

See also

D3DDP2OP_ISSUEQUERY

D3DHAL_DP2COMMAND

D3DHAL_DP2CREATEQUERY

D3DHAL_DP2RESPONSEQUERY

D3dDrawPrimitives2