D3D12_QUERY_HEAP_TYPE enumeration (d3d12.h)

Specifies the type of query heap to create.

Syntax

typedef enum D3D12_QUERY_HEAP_TYPE {
  D3D12_QUERY_HEAP_TYPE_OCCLUSION = 0,
  D3D12_QUERY_HEAP_TYPE_TIMESTAMP = 1,
  D3D12_QUERY_HEAP_TYPE_PIPELINE_STATISTICS = 2,
  D3D12_QUERY_HEAP_TYPE_SO_STATISTICS = 3,
  D3D12_QUERY_HEAP_TYPE_VIDEO_DECODE_STATISTICS = 4,
  D3D12_QUERY_HEAP_TYPE_COPY_QUEUE_TIMESTAMP = 5,
  D3D12_QUERY_HEAP_TYPE_PIPELINE_STATISTICS1
} ;

Constants

 
D3D12_QUERY_HEAP_TYPE_OCCLUSION
Value: 0
This returns a binary 0/1 result: 0 indicates that no samples passed depth and stencil testing, 1 indicates that at least one sample passed depth and stencil testing. This enables occlusion queries to not interfere with any GPU performance optimization associated with depth/stencil testing.
D3D12_QUERY_HEAP_TYPE_TIMESTAMP
Value: 1
Indicates that the heap is for high-performance timing data.
D3D12_QUERY_HEAP_TYPE_PIPELINE_STATISTICS
Value: 2
Indicates the heap is to contain pipeline data. Refer to D3D12_QUERY_DATA_PIPELINE_STATISTICS.
D3D12_QUERY_HEAP_TYPE_SO_STATISTICS
Value: 3
Indicates the heap is to contain stream output data. Refer to D3D12_QUERY_DATA_SO_STATISTICS.
D3D12_QUERY_HEAP_TYPE_VIDEO_DECODE_STATISTICS
Value: 4
Indicates the heap is to contain video decode statistics data. Refer to D3D12_QUERY_DATA_VIDEO_DECODE_STATISTICS.

Video decode statistics can only be queried from video decode command lists (D3D12_COMMAND_LIST_TYPE_VIDEO_DECODE). See D3D12_QUERY_TYPE_DECODE_STATISTICS for more details.
D3D12_QUERY_HEAP_TYPE_COPY_QUEUE_TIMESTAMP
Value: 5
Indicates the heap is to contain timestamp queries emitted exclusively by copy command lists. Copy queue timestamps can only be queried from a copy command list, and a copy command list can not emit to a regular timestamp query Heap.

Support for this query heap type is not universal. You must use CheckFeatureSupport with D3D12_FEATURE_D3D12_OPTIONS3 to determine whether the adapter supports copy queue timestamp queries.

Remarks

This enum is used by the D3D12_QUERY_HEAP_DESC structure.

Requirements

Requirement Value
Header d3d12.h

See also

Core enumerations