PFND3DDDI_ISSUEQUERY callback function

The IssueQuery function processes a query.

Syntax


PFND3DDDI_ISSUEQUERY IssueQuery;

__checkReturn HRESULT APIENTRY IssueQuery(
  _In_       HANDLE               hDevice,
  _In_ const D3DDDIARG_ISSUEQUERY *pData
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

pData [in]

A pointer to a D3DDDIARG_ISSUEQUERY structure that describes how to process the query.

Return value

IssueQuery returns one of the following values:

Return codeDescription
S_OK

The query is successfully processed.

E_OUTOFMEMORY

IssueQuery could not allocate the required memory for it to complete.

 

Remarks

The user-mode display driver should set a fence value and store the fence value in the driver's private query structure. The user-mode display driver implements the query by using a fence. If the IssueQuery function is called on a query again before a previous query issue completes, the driver should overwrite the fence value and ignore the previous query issue.

If the call to IssueQuery requires the driver to return data, the driver should insert a graphics processing unit (GPU) instruction to write the required data to an allocation. In the call to the GetQueryData function, the driver should typically lock the allocation and return the appropriate data.

Requirements

Target platform

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dumddi.h (include D3dumddi.h)

See also

CreateQuery
D3DDDIARG_ISSUEQUERY
D3DDDI_DEVICEFUNCS
GetQueryData
pfnRenderCb

 

 

Send comments about this topic to Microsoft

Show: