WdfDmaTransactionFreeResources 函式 (wdfdmatransaction.h)

  • 發行項

[僅適用於 KMDF]

WdfDmaTransactionFreeResources 方法會釋放驅動程式先前藉由呼叫 WdfDmaTransactionAllocateResources 配置的 DMA 資源。

語法

void WdfDmaTransactionFreeResources(
  [in] WDFDMATRANSACTION DmaTransaction
);

參數

[in] DmaTransaction

DMA 交易物件的句柄，驅動程式在先前呼叫 WdfDmaTransactionAllocateResources 中提供。

傳回值

無

備註

WdfDmaTransactionFreeResources 必須與指定封包或系統配置檔的 DMA 啟用程式搭配使用。

在早於 Windows 8 的操作系統上，WdfDmaTransactionFreeResources 必須與指定單一封包 DMA 啟用器的啟用程式搭配使用。 從 Windows 8 開始，WdfDmaTransactionFreeResources 也可以搭配指定系統模式 DMA 啟用器的啟用程式使用。

使用散佈圖/收集 DMA 啟用器呼叫時， WdfDmaTransactionFreeResources 會導致驗證程式錯誤檢查。

驅動程式對 WdfDmaTransactionFreeResources 的呼叫可能會導致架構立即呼叫 EvtProgramDma 或 EvtReserveDma 。

如需系統模式 DMA 的詳細資訊，請參閱 支援 DMA System-Mode。

規格需求

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

另請參閱

WdfDmaTransactionAllocateResources