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