閱讀英文

共用方式為

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 旗標。

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

要求

要求 價值
目標平臺 窗戶
標頭 d3dkmddi.h

另請參閱

DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3