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

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

言論

此函式會從被動層級呼叫。

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

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

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

要求

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