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 |