IDirect3DDevice9::CreateQuery

Creates a status query.

HRESULT CreateQuery(
  D3DQUERYTYPE Type,
  IDirect3DQuery9** ppQuery
);

Parameters

Type

[in] Identifies the query type. For more information, see D3DQUERYTYPE.

ppQuery

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

[out] 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 Values

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

Header: Declared in D3d9.h.

See Also

Asynchronous Notification