共用方式為

DXGKDDI_CANCELCOMMAND回呼函式 （d3dkmddi.h）

  • 發行項

清除與 GPU 排程器軟體佇列中之直接記憶體取 （DMA） 封包相關聯的內部資源，但從未到達硬體佇列，因為裝置進入錯誤狀態。 這類錯誤狀態通常是由 逾時偵測和復原 （TDR） 事件所造成。

語法

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

NTSTATUS DxgkddiCancelcommand(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_CANCELCOMMAND pCancelCommand
)
{...}

參數

hAdapter

與顯示配接器相關聯的內容區塊句柄。 顯示迷你埠驅動程式先前已提供此句柄給 MiniportDeviceContextDxgkDdiAddDevice 函式的 DirectX 圖形核心子系統。

pCancelCommand

DXGKARG_CANCELCOMMAND 結構的指標，指定要在命令從硬體佇列中移除之後清除的資源。

傳回值

成功完成時傳回 STATUS_SUCCESS。 如果驅動程式改為傳回錯誤碼，則作系統會導致發生系統錯誤檢查。 如需詳細資訊，請參閱下列一節。

言論

注意 DirectX 圖形核心子系統只有在 DXGK_VIDSCHCAPS時才呼叫此函式。已設定 CancelCommandAware 成員。
 
如果驅動程式傳回錯誤碼，DirectX 圖形核心子系統會導致系統錯誤檢查發生。 在損毀傾印檔案中，錯誤是由錯誤訊息 BugCheck 0x119所指出，其具有下列四個參數。
  1. 0x9
  2. 從失敗的驅動程式呼叫傳回的NTSTATUS錯誤碼
  3. DXGKARG_CANCELCOMMAND 結構的指標
  4. 內部排程器數據結構的指標

要求

要求 價值
最低支援的用戶端 Windows 8
支援的最低伺服器 Windows Server 2012
目標平臺 桌面
標頭 d3dkmddi.h
IRQL PASSIVE_LEVEL

另請參閱

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice