WdfDmaTransactionCreate 函数 (wdfdmatransaction.h)

[仅适用于 KMDF]

WdfDmaTransactionCreate 方法创建 DMA 事务。

语法

NTSTATUS WdfDmaTransactionCreate(
  [in]           WDFDMAENABLER          DmaEnabler,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          WDFDMATRANSACTION      *DmaTransaction
);

参数

[in] DmaEnabler

从上一次调用 WdfDmaEnablerCreate 获取的驱动程序获取的 DMA 启用器对象的句柄。

[in, optional] Attributes

指向 WDF_OBJECT_ATTRIBUTES 结构的指针,该结构指定新 DMA 事务对象的对象属性。 (结构的 ParentObject 成员必须为 NULL。) 此参数是可选的,并且可以WDF_NO_OBJECT_ATTRIBUTES。

[out] DmaTransaction

DMA 事务对象的句柄。

返回值

如果操作成功,WdfDmaTransactionCreate 将返回STATUS_SUCCESS。 否则,此方法可能会返回以下值之一:

返回代码 说明
STATUS_INVALID_PARAMETER
检测到无效参数。
STATUS_INSUFFICIENT_RESOURCES
内存不足,无法创建新的 DMA 事务对象。
 

有关 WdfDmaTransactionCreate 方法可能返回的其他返回值的列表,请参阅 框架对象创建错误

此方法还可以返回其他 NTSTATUS 值

如果驱动程序提供无效的对象句柄,则会发生 bug 检查。

注解

驱动程序调用 WdfDmaTransactionCreate 后,必须先调用 WdfDmaTransactionInitializeWdfDmaTransactionInitializeUsingRequest ,然后再调用 WdfDmaTransactionExecute

指定的 DMA 启用器对象将成为新 DMA 事务对象的父对象。 驱动程序无法更改此父级, ParentObject 成员或 WDF_OBJECT_ATTRIBUTES 结构必须为 NULL

有关 DMA 事务的详细信息,请参阅 创建和初始化 DMA 事务

示例

有关使用 WdfDmaTransactionCreate 的代码示例,请参阅 WdfDmaTransactionExecute

要求

   
目标平台 通用
最低 KMDF 版本 1.0
Header wdfdmatransaction.h (包括 Wdf.h)
Library Wdf01000.sys (请参阅框架库版本控制.)
IRQL <=DISPATCH_LEVEL
DDI 符合性规则 DriverCreate (kmdf) KmdfIrql (kmdf) KmdfIrql2 (kmdf) 、KmdfIrqlExplicit (kmdf)

另请参阅

WDF_OBJECT_ATTRIBUTES

WdfDmaEnablerCreate

WdfDmaTransactionExecute

WdfDmaTransactionInitialize

WdfDmaTransactionInitializeUsingRequest