DXGKDDI_SUBMITCOMMAND回呼函式 (d3dkmddi.h)

DxgkDdiSubmitCommand 函式會將直接記憶體存取 (DMA) 緩衝區提交至硬體命令執行單位。

語法

DXGKDDI_SUBMITCOMMAND DxgkddiSubmitcommand;

NTSTATUS DxgkddiSubmitcommand(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SUBMITCOMMAND pSubmitCommand
)
{...}

參數

[in] hAdapter

與顯示配接器相關聯的內容區塊句柄。 顯示迷你埠驅動程式先前已將此句柄提供給 DxgkDdiAddDevice 函式之 MiniportDeviceContext 輸出參數中的 Microsoft DirectX 圖形核心子系統。

[in] pSubmitCommand

DXGKARG_SUBMITCOMMAND 結構的指標，描述顯示迷你埠驅動程式提交至硬體命令執行單位的 DMA 緩衝區。

傳回值

DxgkDdiSubmitCommand 會在成功完成時傳回 STATUS_SUCCESS 。 如果驅動程式改為傳回錯誤碼，操作系統就會發生系統錯誤檢查。 請參閱＜備註＞。

備註

因為分頁作業被視為系統作業，所以它們不會與特定的應用程式內容或圖形內容相關聯。 因此，提交用於分頁作業時，會呼叫 DxgkDdiSubmitCommand 函式，並在 pSubmitCommand 參數指向之DXGKARG_SUBMITCOMMAND結構的 hDevice 成員中指定 NULL。

不過，如果特定硬體和驅動程式的架構必須在內部有裝置，則驅動程式必須在適配卡初始化期間於內部建立裝置，而且必須讓裝置在內部保持為系統默認裝置，才能用於分頁作業。

驅動程式可以將 DXGKARG_SUBMITCOMMAND 提交FenceId 成員中提供的值寫入環形緩衝區中的柵欄命令。 如需柵欄命令的詳細資訊，請參閱 提供柵欄標識碼。

如果驅動程式傳回錯誤碼，DirectX 圖形核心子系統會造成系統錯誤檢查發生。 在損毀傾印檔案中，錯誤訊息 BugCheck 0x119會記錄錯誤，其會有下列四個參數。

• 0x2 (识别错误原因)
• 從失敗的驅動程式呼叫傳回的NTSTATUS錯誤碼
• DXGKARG_SUBMITCOMMAND 結構的指標
• 內部排程器數據結構的指標

DxgkDdiSubmitCommand 應該設為不可分頁，因為它會在 IRQL = DISPATCH_LEVEL執行。

規格需求

另請參閱

DXGKARG_SUBMITCOMMAND

DxgkDdiAddDevice