D3DQUERYTYPE enumeration

Identifies the query type. For information about queries, see Queries (Direct3D 9)

Syntax

typedef enum D3DQUERYTYPE { 
  D3DQUERYTYPE_VCACHE             = 4,
  D3DQUERYTYPE_RESOURCEMANAGER    = 5,
  D3DQUERYTYPE_VERTEXSTATS        = 6,
  D3DQUERYTYPE_EVENT              = 8,
  D3DQUERYTYPE_OCCLUSION          = 9,
  D3DQUERYTYPE_TIMESTAMP          = 10,
  D3DQUERYTYPE_TIMESTAMPDISJOINT  = 11,
  D3DQUERYTYPE_TIMESTAMPFREQ      = 12,
  D3DQUERYTYPE_PIPELINETIMINGS    = 13,
  D3DQUERYTYPE_INTERFACETIMINGS   = 14,
  D3DQUERYTYPE_VERTEXTIMINGS      = 15,
  D3DQUERYTYPE_PIXELTIMINGS       = 16,
  D3DQUERYTYPE_BANDWIDTHTIMINGS   = 17,
  D3DQUERYTYPE_CACHEUTILIZATION   = 18,
  D3DQUERYTYPE_MEMORYPRESSURE     = 19
} D3DQUERYTYPE, *LPD3DQUERYTYPE;

Constants

D3DQUERYTYPE_VCACHE

Query for driver hints about data layout for vertex caching.

D3DQUERYTYPE_ResourceManager

Query the resource manager. For this query, the device behavior flags must include D3DCREATE_DISABLE_DRIVER_MANAGEMENT.

D3DQUERYTYPE_VERTEXSTATS

Query vertex statistics.

D3DQUERYTYPE_EVENT

Query for any and all asynchronous events that have been issued from API calls.

D3DQUERYTYPE_OCCLUSION

An occlusion query returns the number of pixels (or samples when multisampling is enabled) that pass z-testing. These pixels/samples are for primitives drawn between the issue of D3DISSUE_BEGIN and D3DISSUE_END. This enables an application to check the occlusion result against 0. Zero is fully occluded, which means the pixels/samples are not visible from the current camera position. To get the number of pixels when a multisampled render target is used, the result should be divided by the sample count of the target.

D3DQUERYTYPE_TIMESTAMP

Returns a 64-bit timestamp.

D3DQUERYTYPE_TIMESTAMPDISJOINT

Use this query to notify an application if the counter frequency has changed from the D3DQUERYTYPE_TIMESTAMP.

D3DQUERYTYPE_TIMESTAMPFREQ

This query result is TRUE if the values from D3DQUERYTYPE_TIMESTAMP queries cannot be guaranteed to be continuous throughout the duration of the D3DQUERYTYPE_TIMESTAMPDISJOINT query. Otherwise, the query result is FALSE.

D3DQUERYTYPE_PIPELINETIMINGS

Percent of time processing pipeline data.

D3DQUERYTYPE_INTERFACETIMINGS

Percent of time processing data in the driver.

D3DQUERYTYPE_VERTEXTIMINGS

Percent of time processing vertex shader data.

D3DQUERYTYPE_PIXELTIMINGS

Percent of time processing pixel shader data.

D3DQUERYTYPE_BANDWIDTHTIMINGS

Throughput measurement comparisons for help in understanding the performance of an application.

D3DQUERYTYPE_CACHEUTILIZATION

Measure the cache hit-rate performance for textures and indexed vertices.

D3DQUERYTYPE_MEMORYPRESSURE

Efficiency of memory allocation contained in a D3DMEMORYPRESSURE structure.

Differences between Direct3D 9 and Direct3D 9Ex:

• D3DQUERYTYPE_MEMORYPRESSURE is only available in Direct3D9Ex running on Windows 7 (or more current operating system).

 

Requirements

See also

Direct3D Enumerations

IDirect3DDevice9::CreateQuery