WdfDmaTransactionWdmGetTransferContext 函数 (wdfdmatransaction.h)

[仅适用于 KMDF]

WdfDmaTransactionWdmGetTransferContext 方法检索与 DMA 事务关联的 WDM 传输上下文。

语法

PVOID WdfDmaTransactionWdmGetTransferContext(
  [in] WDFDMATRANSACTION DmaTransaction
);

[in] DmaTransaction

从中检索传输上下文的已初始化 DMA 事务对象的句柄。

指向与事务关联的 DMA 传输上下文 (PTRANSFER_CONTEXT) 的指针。

当驱动程序创建事务时，将分配事务的 DMA 传输上下文。

WdfDmaTransactionWdmGetTransferContext 必须与使用 DMA 版本 3 的 DMA 启用程序一起使用。若要选择版本 3，请将 WDF_DMA_ENABLER_CONFIG 的 WdmDmaVersionOverride 成员设置为 3。

驱动程序可以使用 DMA 传输上下文直接调用以下 WDM DMA 库例程：

在调用 WdfDmaTransactionWdmGetTransferContext 之前，必须初始化 DMA 事务。