PFND3DDDI_ISSUEQUERY callback function (d3dumddi.h)

Article
02/22/2024

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)