PFND3DDDI_ISSUEQUERY callback function (d3dumddi.h)

The IssueQuery function processes a query.

Syntax

PFND3DDDI_ISSUEQUERY Pfnd3dddiIssuequery;

HRESULT Pfnd3dddiIssuequery(
  HANDLE hDevice,
  const D3DDDIARG_ISSUEQUERY *unnamedParam2
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

unnamedParam2

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 code Description
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

Requirement Value
Minimum supported client Available in Windows Vista and later versions of the Windows operating systems.
Target Platform Desktop
Header d3dumddi.h (include D3dumddi.h)

See also

CreateQuery

D3DDDIARG_ISSUEQUERY

D3DDDI_DEVICEFUNCS

GetQueryData

pfnRenderCb