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) |