PFND3D12DDI_BEGIN_END_QUERY 콜백 함수(d3d12umddi.h)

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

구문

PFND3D12DDI_BEGIN_END_QUERY Pfnd3d12ddiBeginEndQuery;

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

매개 변수

unnamedParam1

hCommandList

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

unnamedParam2

hQueryHeap

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

unnamedParam3

StartElement

start 요소의 값입니다.

unnamedParam4

QueryType

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

반환 값

없음

설명

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

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10
머리글	d3d12umddi.h(d3d12umddi.h 포함)