D3D10_QUERY enumeration (d3d10.h)

  • Article

Query types.

Syntax

typedef enum D3D10_QUERY {
  D3D10_QUERY_EVENT = 0,
  D3D10_QUERY_OCCLUSION,
  D3D10_QUERY_TIMESTAMP,
  D3D10_QUERY_TIMESTAMP_DISJOINT,
  D3D10_QUERY_PIPELINE_STATISTICS,
  D3D10_QUERY_OCCLUSION_PREDICATE,
  D3D10_QUERY_SO_STATISTICS,
  D3D10_QUERY_SO_OVERFLOW_PREDICATE
} ;

Constants

 
D3D10_QUERY_EVENT
Value: 0
Determines whether or not the GPU is finished processing commands. When the GPU is finished processing commands GetData will return S_OK, and pData will point to a BOOL with a value of TRUE. When using this type of query, Begin is disabled.
D3D10_QUERY_OCCLUSION
Get the number of samples that passed the depth and stencil tests in between Begin and End. GetData returns a UINT64. If a depth or stencil test is disabled, then each of those tests will be counted as a pass.
D3D10_QUERY_TIMESTAMP
Get a timestamp value where GetData returns a UINT64. This kind of query is only useful if two timestamp queries are done in the middle of a D3D10_QUERY_TIMESTAMP_DISJOINT query. The difference of two timestamps can be used to determine how many ticks have elapsed, and the D3D10_QUERY_TIMESTAMP_DISJOINT query will determine if that difference is a reliable value and also has a value that shows how to convert the number of ticks into seconds. See D3D10_QUERY_DATA_TIMESTAMP_DISJOINT. When using this type of query, Begin is disabled.
D3D10_QUERY_TIMESTAMP_DISJOINT
Determines whether or not a D3D10_QUERY_TIMESTAMP is returning reliable values, and also gives the frequency of the processor enabling you to convert the number of elapsed ticks into seconds. GetData will return a D3D10_QUERY_DATA_TIMESTAMP_DISJOINT. This type of query should only be invoked once per frame or less.
D3D10_QUERY_PIPELINE_STATISTICS
Get pipeline statistics, such as the number of pixel shader invocations in between Begin and End. GetData will return a D3D10_QUERY_DATA_PIPELINE_STATISTICS.
D3D10_QUERY_OCCLUSION_PREDICATE
Similar to D3D10_QUERY_OCCLUSION, except GetData returns a BOOL indicating whether or not any samples passed the depth and stencil tests - TRUE meaning at least one passed, FALSE meaning none passed.
D3D10_QUERY_SO_STATISTICS
Get streaming output statistics, such as the number of primitives streamed out in between Begin and End. GetData will return a D3D10_QUERY_DATA_SO_STATISTICS structure.
D3D10_QUERY_SO_OVERFLOW_PREDICATE
Determines whether or not any of the streaming output buffers overflowed in between Begin and End. GetData returns a BOOL - TRUE meaning there was an overflow, FALSE meaning there was not an overflow. If streaming output writes to multiple buffers, and one of the buffers overflows, then it will stop writing to all the output buffers. When an overflow is detected by Direct3D it is prevented from happening - no memory is corrupted. This predication may be used in conjunction with an SO_STATISTICS query so that when an overflow occurs the SO_STATISTIC query will let the application know how much memory was needed to prevent an overflow.

Requirements

Requirement Value
Header d3d10.h

See also

Core Enumerations