DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT回呼函式 (d3dkmddi.h)

在新的多平面重疊設定生效之後呼叫，讓驅動程式能夠優化硬體狀態。 選擇性的 Windows 顯示驅動程式模型 (WDDM) 支援多平面重疊的 2.0 或更新版本驅動程式。

語法

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT DxgkddiPostmultiplaneoverlaypresent;

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

參數

hAdapter

識別包含重疊硬體的適配卡。

pPostPresent

DXGKARG_POSTMULTIPLANEOVERLAYPRESENT 結構的指標，描述最近認可的新重迭組態。

傳回值

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT 會傳回下列值：

傳回碼	Description
STATUS_SUCCESS	如果例程已順利完成。 驅動程序應該一律傳回成功碼。 失敗會導致錯誤檢查。

備註

此函式是從 PASSIVE 層級呼叫。

只有在驅動程式在 VSYNC 回呼中設定DXGKARGCB_NOTIFY_INTERRUPT_DATA結構DXGKCB_NOTIFY_MPO_VSYNC_FLAGS成員的 PostPresentNeeded 時，才會呼叫此函式。

驅動程式可以使用此函式來降低電壓等級、時鐘、FIFO 深度，或任何其他可節省電源的優化。

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

規格需求

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