WdfDmaTransactionCancel 函式 (wdfdmatransaction.h)

[僅適用於 KMDF]

WdfDmaTransactionCancel 方法會嘗試取消正在等候地圖緩存器配置的 DMA 交易。

語法

BOOLEAN WdfDmaTransactionCancel(
  [in] WDFDMATRANSACTION DmaTransaction
);

[in] DmaTransaction

DMA 交易物件的句柄，表示正在取消的交易。此交易必須由驅動程式初始化。

如果架構成功取消對應緩存器配置，WdfDmaTransactionCancel 會傳回 TRUE。在此情況下，不會完成傳輸，而且架構在重新初始化之前，不會對交易進行額外的 DMA 回呼。

如果另一個線程已經處理此交易，或者驅動程式尚未呼叫 WdfDmaTransactionExecute，則此方法會傳回 FALSE。在第一個案例中，架構目前正在呼叫或呼叫 EvtProgramDma 或 EvtReserveDma。此時，指定系統模式 DMA 配置檔的驅動程式可能會呼叫 WdfDmaTransactionStopSystemTransfer。

如果使用從 DMA 第 2 版啟用程式設定的交易呼叫，此方法也會傳回 FALSE。

驅動程式可能會從 EvtRequestCancel 事件回呼函式呼叫 WdfDmaTransactionCancel，該函式會在呼叫 WdfRequestMarkCancelableEx 中提供。如需示範如何執行此動作的程式代碼範例，請參閱 WdfDmaTransactionStopSystemTransfer。

驅動程式也可能從 EvtIoCanceledOnQueue 事件回呼函式呼叫 WdfDmaTransactionCancel。

只有在呼叫 WdfDmaTransactionCancel 之後呼叫 WdfDmaTransactionExecute，但在 WdfDmaTransactionExecute 方法啟動 DMA 配置之前，才會成功取消。如需詳細資訊，請參閱取消 DMA 交易。

驅動程式必須在呼叫 WdfDmaTransactionInitialize 之後呼叫 WdfDmaTransactionCancel，但在呼叫 WdfDmaTransactionRelease 或 WdfObjectDelete 以刪除交易物件之前。

在架構呼叫 EvtProgramDma 或 EvtReserveDma 之後，請勿呼叫 WdfDmaTransactionCancel。

驅動程序必須先要求使用 DMA 第 3 版，才能呼叫 WdfDmaTransactionCancel。若要選取 DMA 第 3 版，請將 WDF_DMA_ENABLER_CONFIG 的 WdmDmaVersionOverride 成員設定為 3。

如果驅動程式在從 DMA 第 2 版啟用程式配置的交易上呼叫 WdfDmaTransactionCancel ，架構會產生驗證器錯誤， 而 WdfDmaTransactionCancel 會傳回 FALSE。在此情況下，不會嘗試取消交易。

需求	值
最低支援的用戶端	Windows 8
目標平台	Universal
最小 KMDF 版本	1.11
標頭	wdfdmatransaction.h (包含 Wdf.h)
程式庫	Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL	<=DISPATCH_LEVEL
DDI 合規性規則	DriverCreate (kmdf)