Skip to main content
Creates a query heap. A query heap contains an array of queries.

Syntax

Parameters

pDesc [in]
Type: const D3D12_QUERY_HEAP_DESC *
Specifies the query heap in a D3D12_QUERY_HEAP_DESC structure. riid
Type: const IID &
Specifies a REFIID that uniquely identifies the heap. ppvHeap [out, optional]
Type: void **
Specifies a pointer to the heap, that will be returned on successful completion of the method. ppvHeap can be NULL, to enable capability testing. When ppvHeap is NULL, no object will be created and S_FALSE will be returned when pDesc is valid.

Return value

Type: HRESULT This method returns one of the Direct3D 12 Return Codes.

Remarks

Refer to Queries for more information.

Examples

The D3D12PredicationQueries sample uses ID3D12Device::CreateQueryHeap as follows: Create a query heap and a query result buffer.
Refer to the Example Code in the D3D12 Reference.

Requirements

Header: d3d12_xs.h or d3d12_x.h
Library: d3d12_xs.lib or d3d12_x.lib
Supported Platforms: XBOX Series consoles and XBOX One family

See Also

ID3D12Device
Last modified on August 20, 2026