Microsoft DirectX 9.0

IDirect3DDevice9::CreateQuery Method

Creates a status query.


HRESULT CreateQuery(      

    D3DQUERYTYPE Type,     IDirect3DQuery9** ppQuery );


[in] Identifies the query type. For more information, see D3DQUERYTYPE.
[out, retval] 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

If the method succeeds, the return value is D3D_OK.

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


This method is provided for both synchronous and asynchronous queries. It takes the place of GetInfo, which is no longer supported in Microsoft?DirectX?9.0.

Synchronous and asynchronous queries are created with IDirect3DDevice9::CreateQuery with D3DQUERYTYPE. Once a query has been created and the application programming interface (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.

See Also

Asynchronous Notification

© 2002 Microsoft Corporation. All rights reserved.