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執行。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平台 | 桌面 |
| 標頭 | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |