WdfDmaTransactionGetTransferInfo 函数 (wdfdmatransaction.h)

  • 项目

[仅适用于 KMDF]

WdfDmaTransactionGetTransferInfo 方法返回初始化的 DMA 事务所需的映射寄存器和散点/收集列表条目的数目。

语法

void WdfDmaTransactionGetTransferInfo(
  [in]            WDFDMATRANSACTION DmaTransaction,
  [out, optional] ULONG             *MapRegisterCount,
  [out, optional] ULONG             *ScatterGatherElementCount
);

参数

[in] DmaTransaction

初始化的 DMA 事务对象的句柄。

[out, optional] MapRegisterCount

调用方提供的位置，返回时包含指定事务所需的映射寄存器数。 此参数是可选的，可以为 NULL。

[out, optional] ScatterGatherElementCount

调用方提供的位置，返回时包含指定事务所需的散点/收集元素数。 此参数是可选的，可以为 NULL。

返回值

无

备注

驱动程序可能会在调用 WdfDmaTransactionAllocateResources 或 WdfDmaTransactionExecute 之前调用 WdfDmaTransactionGetTransferInfo。

使用 DMA 版本 3 时，此方法返回所需的映射寄存器数量的准确计数。 使用早期 DMA 版本时，此方法假定每个页面都需要映射寄存器。

要求

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

另请参阅

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute