DXGKDDI_PRESENTDISPLAYONLY回呼函式 (d3dkmddi.h)
將螢幕影像呈現給核心模式僅顯示驅動程式的顯示裝置, (KMDOD) 。
語法
DXGKDDI_PRESENTDISPLAYONLY DxgkddiPresentdisplayonly;
NTSTATUS DxgkddiPresentdisplayonly(
IN_CONST_HANDLE hAdapter,
IN_CONST_PDXGKARG_PRESENT_DISPLAYONLY pPresentDisplayOnly
)
{...}
參數
hAdapter
顯示適配卡之裝置內容的句柄。 KMDOD 的 DxgkDdiAddDevice 函式先前在 MiniportDeviceContext 參數中傳回此句柄。
pPresentDisplayOnly
包含目前作業相關信息 之DXGKARG_PRESENT_DISPLAYONLY 結構的指標。
傳回值
傳回下列其中一值:
傳回碼 | 描述 |
---|---|
STATUS_SUCCESS | 目前作業已順利完成。 |
STATUS_PENDING | 目前作業已傳送至軟體或硬體佇列以完成。 在此情況下,KMDOD 應該使用中斷和延後的程式調用, (DPC) 來報告目前作業的進度。 否則,操作系統會使用 逾時偵測和復原 (TDR) 程式,其會報告錯誤,並要求 KMDOD 重新初始化本身並重設 GPU。 請注意,此狀態代碼不應針對同步模式傳回,如中所述。 |
驅動程式也可以傳回 Ntstatus.h 中定義的任何其他錯誤狀態代碼,以指出目前作業發生的問題。
備註
KMDOD 必須先完成所有螢幕對螢幕移動,才能複製已變更的矩形。 此外,KMDOD 必須先完成每個移動/複製作業,才能開始另一個移動/複製作業。
操作系統支援兩種 KMDOD 目前作業模式:同步和異步。 根據硬體和驅動程序實作,KMDOD 可以隨時使用模式或切換它們。
操作系統保證此函式遵循線程 和同步處理零層級中所定義的零層級同步處理模式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 |
最低支援的伺服器 | Windows Server 2012 |
目標平台 | 桌面 |
標頭 | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |
另請參閱
DXGKARGCB_NOTIFY_INTERRUPT_DATA