PFND3D12DDI_BEGIN_PASS 콜백 함수(d3d12umddi.h)

앱이 일관된 워크로드의 통과를 시작했다는 알림이 드라이버에 표시됩니다. 드라이버에 앱 패스가 시작되었다는 알림이 표시되면 드라이버는 관찰을 기록하거나 검색된 최적화를 사용합니다.

구문

PFND3D12DDI_BEGIN_PASS Pfnd3d12ddiBeginPass;

void Pfnd3d12ddiBeginPass(
  D3D12DDI_HCOMMANDLIST unnamedParam1,
  D3D12DDI_HPASS unnamedParam2,
  D3D12DDI_PASS_FLAGS PassFlags
)
{...}

매개 변수

unnamedParam1

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

unnamedParam2

앱에서 만든 패스에 대한 핸들입니다.

PassFlags

앱이 패스를 시작할 때 드라이버가 수행해야 하는 작업을 나타내는 플래그입니다.

반환 값

없음

설명

이 콜백은 앱이 일관된 워크로드의 "통과"를 반복할 때 드라이버가 성능 우선을 찾을 수 있는지 확인하기 위한 테스트의 일부로 사용됩니다. 앱은 드라이버에 일부 패스가 실행되는 방식을 관찰하도록 지시하고 드라이버에 동일한 패스의 향후 실행을 최적화할 수 있는 기회를 제공합니다. "패스"의 내용은 무엇이든 될 수 있습니다 - 패스의 전반적인 성능 특성에서 상대적으로 일관성을 유지하는 것은 앱에 달려 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10
최소 UMDF 버전	D3D12DDI_SUPPORTED_0020
머리글	d3d12umddi.h