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 會傳回下列值：

傳回碼 Description
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 旗標。

即使在PASSIVE_LEVEL呼叫時，驅動程式也應該避免在此呼叫中花費大量時間，因為呼叫會封鎖主要 GPU 排程器線程和延遲可能會導致發生問題。 需要大量時間的動作應該依驅動程式排入佇列，並在背景中處理。 在此案例中，佇列專案與未來前置/後置呼叫要求的硬體變更之間的任何衝突，都應該由驅動程式管理。

規格需求

需求 值
目標平台 Windows
標頭 d3dkmddi.h

另請參閱

DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3