Skip to content

Latest commit

 

History

History
82 lines (61 loc) · 2.83 KB

nc-d3d12umddi-pfnd3d12ddi_begin_end_query_0003.md

File metadata and controls

82 lines (61 loc) · 2.83 KB
Raw
UID title description old-location ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos tech.root req.typenames f1_keywords topic_type api_type api_location api_name
NC:d3d12umddi.PFND3D12DDI_BEGIN_END_QUERY_0003
PFND3D12DDI_BEGIN_END_QUERY_0003 (d3d12umddi.h)
The pfnBeginQuery callback function defines the beginning of the portion of a command list to which a query applies.
display\pfnd3d12ddi_begin_end_query_0003.htm
04/16/2018
PFND3D12DDI_BEGIN_END_QUERY_0003 callback function
PFND3D12DDI_BEGIN_END_QUERY_0003, PFND3D12DDI_BEGIN_END_QUERY_0003 callback, d3d12umddi/pfnBeginQuery, display.pfnd3d12ddi_begin_end_query_0003, pfnBeginQuery, pfnBeginQuery callback function [Display Devices]
d3d12umddi.h
D3d12umddi.h
Windows
Windows
display
PFND3D12DDI_BEGIN_END_QUERY_0003
d3d12umddi/PFND3D12DDI_BEGIN_END_QUERY_0003
APIRef
kbSyntax
UserDefined
D3d12umddi.h
PFND3D12DDI_BEGIN_END_QUERY_0003

PFND3D12DDI_BEGIN_END_QUERY_0003 callback function

-description

The pfnBeginQuery callback function defines the beginning of the portion of a command list to which a query applies.

-parameters

-param unnamedParam1

hCommandList

A handle to the driver's data for the command list. The driver uses this region of memory to store internal data structures that are related to its command list.

-param unnamedParam2

hQueryHeap

The handle of a query heap, which represents an array of query results. The underlying data representation of a query result is IHV dependent in query heaps and opaque to applications. Query results are stored in a query heap until they are later “resolved” into the API defined format.

-param unnamedParam3

QueryType

The type of query. Resolve is used by applications to transform a query result previously stored in a query heap into the API defined format. The resolved data is stored in a D3D12 buffer. The results can then be consumed by a shader, predication, or mapped and read on the CPU.

-param unnamedParam4

StartElement

The value of the start element.

-remarks

Begin/End query and resolve query are scheduled commands that are processed on the GPU. There is no defined entry point to allow CPU processing on the query results.

Queries that don’t apply to multiple commands may be defined to only use EndQuery. For example, if the D3D12DDI_QUERY_TYPE_VIDEO_DECODE_STATISTICS query only applies to the previous DecodeFrame command in the same command list, only EndQuery is used for this query type.