PFND3D12DDI_BEGIN_END_QUERY_0003 콜백 함수(d3d12umddi.h)

pfnBeginQuery 콜백 함수는 쿼리가 적용되는 명령 목록 부분의 시작을 정의합니다.

구문

PFND3D12DDI_BEGIN_END_QUERY_0003 Pfnd3d12ddiBeginEndQuery0003;

void Pfnd3d12ddiBeginEndQuery0003(
  D3D12DDI_HCOMMANDLIST unnamedParam1,
  D3D12DDI_HQUERYHEAP unnamedParam2,
  D3D12DDI_QUERY_TYPE unnamedParam3,
  UINT unnamedParam4
)
{...}

매개 변수

unnamedParam1

hCommandList

명령 목록의 드라이버 데이터에 대한 핸들입니다. 드라이버는 이 메모리 영역을 사용하여 명령 목록과 관련된 내부 데이터 구조를 저장합니다.

unnamedParam2

hQueryHeap

쿼리 결과 배열을 나타내는 쿼리 힙의 핸들입니다. 쿼리 결과의 기본 데이터 표현은 IHV가 쿼리 힙에 종속되고 애플리케이션에 불투명합니다. 쿼리 결과는 나중에 API 정의 형식으로 "확인"될 때까지 쿼리 힙에 저장됩니다.

unnamedParam3

QueryType

쿼리 유형입니다. 해결은 애플리케이션에서 이전에 쿼리 힙에 저장된 쿼리 결과를 API 정의 형식으로 변환하는 데 사용됩니다. 확인된 데이터는 D3D12 버퍼에 저장됩니다. 그런 다음, 셰이더, 조건자에서 결과를 사용하거나 CPU에서 매핑하고 읽을 수 있습니다.

unnamedParam4

StartElement

start 요소의 값입니다.

반환 값

없음

설명

시작/종료 쿼리 및 resolve 쿼리는 GPU에서 처리되는 예약된 명령입니다. 쿼리 결과에 대한 CPU 처리를 허용하는 정의된 진입점이 없습니다.

여러 명령에 적용되지 않는 쿼리는 EndQuery만 사용하도록 정의할 수 있습니다. 예를 들어 D3D12DDI_QUERY_TYPE_VIDEO_DECODE_STATISTICS 쿼리가 동일한 명령 목록의 이전 DecodeFrame 명령에만 적용되는 경우 이 쿼리 유형에는 EndQuery만 사용됩니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	d3d12umddi.h(D3d12umddi.h 포함)