DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 콜백 함수(d3dkmddi.h)

  • 아티클

DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 표시 중인 오버레이 구성을 변경하기 위해 호출됩니다.

구문

DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3;

NTSTATUS DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3(
  IN_CONST_HANDLE hAdapter,
  IN_OUT_PDXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 pSetVidPnSourceAddressWithMultiPlaneOverlay
)
{...}

매개 변수

hAdapter

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

pSetVidPnSourceAddressWithMultiPlaneOverlay

표시할 표면 및 표시 옵션을 설명하는 DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 구조체에 대한 포인터입니다.

반환 값

DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 다음 값을 반환합니다.

반환 코드 설명
STATUS_SUCCESS 루틴이 성공적으로 완료되었습니다.
STATUS_INVALID_PARAMETER [하드웨어 대칭 이동 큐 모델]/windows-hardware/drivers/display/hardware-flip-queue에서 드라이버가 대칭 이동 요청을 처리할 수 없습니다.
STATUS_RETRY 드라이버가 보류 중인 대칭 이동으로 인해 하드웨어에 대한 요청을 큐에 대기하지 못했거나 PASSIVE_LEVEL 드라이버를 호출해야 하는 등의 이유로 반환됩니다. PASSIVE_LEVEL 드라이버를 호출해야 하는 경우 DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS 설정해야 합니다.PrePresentNeeded 플래그입니다.

설명

이 함수는 일반적으로 인터럽트 수준에서 호출되지만 드라이버가 PASSIVE_LEVEL만 수행할 수 있는 하드웨어 구성을 수행해야 하는 경우 드라이버는 STATUS_RETRY 반환하고 DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS 설정하여 PASSIVE_LEVEL 이 함수를 회수하도록 요청할 수 있습니다.PrePresentNeeded 플래그입니다.

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

요구 사항

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

추가 정보

DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3