DXGKDDI_CANCELCOMMAND回呼函式 (d3dkmddi.h)

  • 發行項

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

語法

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

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

參數

hAdapter

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

pCancelCommand

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

傳回值

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

備註

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

規格需求

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

另請參閱

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice