DXGKDDI_CALIBRATEGPUCLOCK 콜백 함수(d3dkmddi.h)

Microsoft DirectX 그래픽 커널 하위 시스템에 의해 호출되어 CPU 클록 시간으로 DXGK_HISTORY_BUFFER 기록 버퍼의 GPU 타임스탬프를 보정합니다.

구문

DXGKDDI_CALIBRATEGPUCLOCK DxgkddiCalibrategpuclock;

NTSTATUS DxgkddiCalibrategpuclock(
  IN_CONST_HANDLE hAdapter,
  IN UINT32 NodeOrdinal,
  IN UINT32 EngineOrdinal,
  OUT_PDXGKARG_CALIBRATEGPUCLOCK pClockCalibration
)
{...}

매개 변수

hAdapter

타이밍 보정 정보를 가져올 GPU의 어댑터 개체에 대한 핸들입니다.

디스플레이 미니포트 드라이버는 이전에 DxgkDdiAddDevice 함수의 MiniportDeviceContext 출력 매개 변수에서 DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다.

NodeOrdinal

타이밍 보정 정보를 가져올 노드의 인덱스입니다. 이 노드는 hAdapter 매개 변수로 정의된 물리적 어댑터 내에 있습니다.

EngineOrdinal

NodeOrdinal이 지정하는 노드 내에서 타이밍 보정 정보를 가져올 엔진의 인덱스(0부터 시작)입니다. LDA(연결된 디스플레이 어댑터) 구성에서 링크의 일부가 아닌 그래픽 어댑터의 경우 항상 EngineOrdinal 을 0으로 설정해야 합니다.

pClockCalibration

GPU 및 CPU에서 클록 카운터 정보를 제공하는 DXGKARG_CALIBRATEGPUCLOCK 구조체에 대한 포인터입니다.

반환 값

성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ntstatus.h에 정의된 오류 코드 중 하나를 반환합니다.

설명

DirectX 그래픽 커널 하위 시스템은 pClockCalibration 매개 변수에서 반환된 정보를 사용하여 GPU와 CPU 클록 간의 드리프트를 예측합니다.

보정 부정확성을 최소화하려면 드라이버는 DXGKARG_CALIBRATEGPUCLOCK 구조체의 GpuClockCounter 및 CpuClockCounter 멤버에 대한 값을 가능한 한 거의 동시에 계산해야 합니다.

DirectX 그래픽 커널 하위 시스템은 GPU와 CPU 클록 간의 누적된 드리프트를 최소화하기 위해 이 함수를 일반적으로 30ms마다 한 번 이상 호출하는 경우가 많습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8.1,WDDM 1.3
지원되는 최소 서버	Windows Server 2012 R2
대상 플랫폼	데스크톱
머리글	d3dkmddi.h
IRQL	DISPATCH_LEVEL

추가 정보

DXGKARG_CALIBRATEGPUCLOCK

DXGK_HISTORY_BUFFER

DxgkDdiAddDevice