Blt
Expand Minimize

GetQueryData routine

The GetQueryData function retrieves information about a query.

Syntax


PFND3DDDI_GETQUERYDATA GetQueryData;

__checkReturn HRESULT APIENTRY GetQueryData(
  _In_     HANDLE hDevice,
  _Inout_  const D3DDDIARG_GETQUERYDATA *pData
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

pData [in, out]

A pointer to a D3DDDIARG_GETQUERYDATA structure that contains the information about the query that is retrieved from the driver.

Return value

GetQueryData returns one of the following values:

Return codeDescription
S_OK

The query operation completed and the query result is available.

S_FALSE

GetQueryData returned successfully. However, the query operation did not complete, so the query result is not available.

E_OUTOFMEMORY

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

 

Remarks

The Microsoft Direct3D runtime can call GetQueryData at any time after calling the user-mode display driver's IssueQuery function. The user-mode display driver should check the current fence value against the value that is stored in the driver's private query structure to determine if the query issue is complete.

If the query is completed, the driver should return S_OK; otherwise, the driver should return S_FALSE.

If a driver supports runtime-handled multiple-processor optimizations and exposes a DDI version of 0x0000000B or greater, the runtime will call GetQueryData in a reentrant manner. The driver returns the DDI-version value in the DriverVersion member of the D3D10DDIARG_OPENADAPTER structure in a call to the driver's OpenAdapter function. When the runtime calls GetQueryData in a reentrant manner, one thread can execute inside GetQueryData while another thread that references the same display device executes inside of another user-mode display driver function.

Requirements

Version

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

Header

D3dumddi.h (include D3dumddi.h)

See also

D3DDDIARG_GETQUERYDATA
D3DDDI_DEVICEFUNCS
IssueQuery

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.