DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT 콜백 함수(d3dkmddi.h)

드라이버가 하드웨어 상태를 최적화할 수 있도록 새 다중 평면 오버레이 구성이 적용된 후 호출됩니다. 다중 평면 오버레이를 지원하는 WDDM(Windows 디스플레이 드라이버 모델) 2.0 이상 드라이버의 경우 선택 사항입니다.

구문

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT DxgkddiPostmultiplaneoverlaypresent;

NTSTATUS DxgkddiPostmultiplaneoverlaypresent(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_POSTMULTIPLANEOVERLAYPRESENT pPostPresent
)
{...}

매개 변수

hAdapter

오버레이 하드웨어를 포함하는 어댑터를 식별합니다.

pPostPresent

최근에 커밋된 새 오버레이 구성을 설명하는 DXGKARG_POSTMULTIPLANEOVERLAYPRESENT 구조체에 대한 포인터입니다.

반환 값

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT 다음 값을 반환합니다.

반환 코드	설명
STATUS_SUCCESS	루틴이 성공적으로 완료된 경우. 드라이버는 항상 성공 코드를 반환해야 합니다. 실패하면 버그 검사가 발생합니다.

설명

이 함수는 PASSIVE 수준에서 호출됩니다.

이 함수는 드라이버가 VSYNC 콜백에서 DXGKARGCB_NOTIFY_INTERRUPT_DATA 구조체의 DXGKCB_NOTIFY_MPO_VSYNC_FLAGS 멤버의 PostPresentNeeded를 설정하는 경우에만 호출됩니다.

드라이버는 이 함수를 사용하여 전압 수준, 클록, FIFO 깊이 또는 전원을 절약할 수 있는 기타 최적화를 낮출 수 있습니다.

호출이 기본 GPU 스케줄러 스레드를 차단하고 지연으로 인해 결함이 발생할 수 있으므로 드라이버는 이 호출에 상당한 시간을 소비해서는 안 됩니다. 시간 집약적 작업은 드라이버별로 별도의 작업 항목으로 큐에 대기하고 백그라운드에서 처리해야 합니다. 이 시나리오에서는 대기 중인 항목과 향후 사전/사후 호출에서 요구하는 하드웨어 변경 내용 간의 충돌을 드라이버에서 관리해야 합니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	d3dkmddi.h