[僅適用於 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 的詳細資訊，請參閱 支援 System-Mode DMA。
需求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.11 |
| 標題 | wdfdmatransaction.h （包括 Wdf.h） |
| 程式庫 | Wdf01000.sys （請參閱架構連結庫版本控制。） |
| IRQL | <=DISPATCH_LEVEL |
| DDI 合規性規則 | DriverCreate（kmdf） |