D3DKMTSubmitCommand 函式 (d3dkmthk.h)

D3DKMTSubmitCommand 可用來在支援圖形處理單位的內容上提交命令緩衝區, (GPU) 虛擬尋址。 這些內容會直接從使用者模式產生命令、管理自己的命令緩衝池,而且不會使用配置或修補程式位置清單。

語法

NTSTATUS D3DKMTSubmitCommand(
  [in] const D3DKMT_SUBMITCOMMAND *unnamedParam1
);

參數

[in] unnamedParam1

描述作業之D3DKMT_SUBMITCOMMAND結構的指標。

傳回值

傳回碼 Description
STATUS_SUCCESS 已成功建立裝置內容。
STATUS_INVALID_PARAMETER 已驗證參數,並判斷為不正確。

此函式也可能傳回其他 NTSTATUS 值。

備註

此函式會取代這類內容的舊 Render 函式,而且必須用於其位置。 在舊版修補程式模式中運作的內容必須繼續使用舊的 Render 函式。

雖然使用者模式驅動程式不會產生修補程式位置,但仍必須產生要寫入的主要項目清單。 視訊記憶體管理員會使用配置清單來判斷每個命令緩衝區要參考哪些主要配置以供寫入。 這項資訊是用來同步轉譯至主要複本與 翻轉 作業。

某些核心模式驅動程式需要使用者模式驅動程式的資訊,以瞭解如何將特定的直接記憶體存取 (DMA) 緩衝區提交至 GPU。 在 Windows 顯示驅動程式模型 (WDDM) 1.0 中,這項資訊是由使用者模式驅動程式透過命令緩衝區傳送至核心模式驅動程式。 由於 DMA 緩衝區是由使用者模式驅動程式直接建置,並提交至 GPU,而不需要修改,就無法再用來將資訊傳送至核心驅動程式。 若要啟用使用者模式與核心模式驅動程式之間的資訊傳輸,已新增明確的私人驅動程式數據緩衝區,以連同提交一起傳送。

注意

此私人驅動程式數據是單向的,核心模式驅動程式無法透過這個緩衝區將資訊傳回給使用者模式驅動程式。

規格需求

需求
最低支援的用戶端 Windows 10
最低支援的伺服器 Windows Server 2016
目標平台 Universal
標頭 d3dkmthk.h (包含 D3dkmthk.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

D3DKMT_SUBMITCOMMAND