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 |