IDirect3DDevice9::CreateQuery method (d3d9.h)

Article
02/22/2024

Creates a status query.

Syntax

HRESULT CreateQuery(
  [in]          D3DQUERYTYPE    Type,
  [out, retval] IDirect3DQuery9 **ppQuery
);

Parameters

[in] Type

Type: D3DQUERYTYPE

Identifies the query type. For more information, see D3DQUERYTYPE.

[out, retval] ppQuery

Type: IDirect3DQuery9**

Returns a pointer to the query interface that manages the query object. See IDirect3DQuery9.

This parameter can be set to NULL to see if a query is supported. If the query is not supported, the method returns D3DERR_NOTAVAILABLE.

Return value

Type: HRESULT

If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be D3DERR_NOTAVAILABLE or E_OUTOFMEMORY.

Remarks

This method is provided for both synchronous and asynchronous queries. It takes the place of GetInfo, which is no longer supported in Direct3D 9.

Synchronous and asynchronous queries are created with IDirect3DDevice9::CreateQuery with D3DQUERYTYPE. When a query has been created and the API calls have been made that are being queried, use IDirect3DQuery9::Issue to issue a query and IDirect3DQuery9::GetData to get the results of the query.

Requirements

Requirement	Value
Target Platform	Windows
Header	d3d9.h (include D3D9.h)
Library	D3D9.lib