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