共用方式為


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

DXGKARG_PRESENT_DISPLAYONLY

DxgkCbNotifyDpc

DxgkCbNotifyInterrupt

DxgkCbPresentDisplayOnlyProgress

DxgkCbQueueDpc

DxgkDdiAddDevice