WdfDmaTransactionFreeResources 函数 (wdfdmatransaction.h)

[仅适用于 KMDF]

WdfDmaTransactionFreeResources 方法释放驱动程序先前通过调用 WdfDmaTransactionAllocateResources分配的 DMA 资源。

语法

void WdfDmaTransactionFreeResources(
  [in] WDFDMATRANSACTION DmaTransaction
);

参数

[in] DmaTransaction

驱动程序在上一次调用 WdfDmaTransactionAllocateResources中提供的 DMA 事务对象的句柄。

返回值

没有

注解

WdfDmaTransactionFreeResources 必须与指定数据包或系统配置文件的 DMA 启用器一起使用。

在早于 Windows 8 的作系统上,WdfDmaTransactionFreeResources 必须与指定单数据包 DMA 启用器的启用器一起使用。 从 Windows 8 开始,WdfDmaTransactionFreeResources 还可用于指定系统模式 DMA 启用器的启用器。

使用散点/收集 DMA 启用器调用时,WdfDmaTransactionFreeResources 会导致验证程序 bug 检查。

驱动程序调用 WdfDmaTransactionFreeResources 可能会导致框架立即调用 EvtProgramDmaEvtReserveDma

有关系统模式 DMA 的详细信息,请参阅 支持 System-Mode DMA

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.11
标头 wdfdmatransaction.h (包括 Wdf.h)
图书馆 Wdf01000.sys(请参阅框架库版本控制。
IRQL <=DISPATCH_LEVEL
DDI 符合性规则 DriverCreate(kmdf)

另请参阅

WdfDmaTransactionAllocateResources