Microsoft DirectX 9.0

IDirect3DDevice9::CreateQuery Method


Creates a status query.

Syntax

HRESULT CreateQuery(      

    D3DQUERYTYPE Type,     IDirect3DQuery9** ppQuery );

Parameters

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



Remarks

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.