Microsoft DirectX 9.0 |
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