[仅适用于 KMDF]
WdfDmaTransactionInitializeUsingRequest 方法使用指定 I/O 请求的参数初始化指定的 DMA 事务。
语法
NTSTATUS WdfDmaTransactionInitializeUsingRequest(
[in] WDFDMATRANSACTION DmaTransaction,
[in] WDFREQUEST Request,
[in] PFN_WDF_PROGRAM_DMA EvtProgramDmaFunction,
[in] WDF_DMA_DIRECTION DmaDirection
);
参数
[in] DmaTransaction
驱动程序从上一次调用 WdfDmaTransactionCreate获取的 DMA 事务对象的句柄。
[in] Request
框架请求对象的句柄。
[in] EvtProgramDmaFunction
指向驱动程序 EvtProgramDma 事件回调函数的指针。
[in] DmaDirection
指定 DMA 传输方向的 WDF_DMA_DIRECTION类型值。
返回值
WdfDmaTransactionInitializeUsingRequest 如果作成功，则返回STATUS_SUCCESS。 否则，该方法可能会返回 WdfDmaTransactionInitialize的“返回值”部分中所述的值之一。
此方法还可以 返回其他NTSTATUS 值。
如果驱动程序提供无效的对象句柄，则会发生 bug 检查。
注解
WdfDmaTransactionInitializeUsingRequest 方法通过执行初始化作（例如设置事务的散点/收集列表）来准备执行 DMA作。 驱动程序 WdfDmaTransactionInitializeUsingRequest调用后，驱动程序必须调用 WdfDmaTransactionExecute。
驱动程序可以调用 WdfRequestGetParameters 以获取请求的类型。 驱动程序为 DmaDirection 参数指定的值必须适用于请求类型，如下所示：
- 如果满足以下条件，则必须 WdfDmaDirectionReadFromDeviceDmaDirection 值：
- 请求类型 WdfRequestTypeRead
- 请求类型 WdfRequestTypeDeviceControl 或 WdfRequestTypeDeviceControlInternal，I/O 控件代码指定传输类型METHOD_OUT_DIRECT
-
如果满足以下条件，则必须 WdfDmaDirectionWriteToDeviceDmaDirection 值：
- 请求类型 WdfRequestTypeWrite
- 请求类型 WdfRequestTypeDeviceControl 或 WdfRequestTypeDeviceControlInternal，I/O 控件代码指定传输类型METHOD_IN_DIRECT
基于框架的驱动程序通常从 I/O 队列事件回调函数中调用 WdfDmaTransactionInitializeUsingRequest。
如果创建基于框架请求对象包含的信息的 DMA 事务，驱动程序应调用 WdfDmaTransactionInitializeUsingRequest。 如果要创建不基于请求对象的 DMA 事务，请使用 WdfDmaTransactionInitialize。
如果请求对象描述的缓冲区大于驱动程序在调用 WdfDmaEnablerCreate 或 WdfDmaTransactionSetMaximumLength时指定的最大传输长度，则框架会将事务分解为多个 传输。
有关 DMA 事务的详细信息，请参阅 创建和初始化 DMA 事务。
例子
有关使用 WdfDmaTransactionInitializeUsingRequest的代码示例，请参阅 WdfDmaTransactionExecute。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 标头 | wdfdmatransaction.h （包括 Wdf.h） |
| 图书馆 | Wdf01000.sys（请参阅框架库版本控制。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI 符合性规则 | DeferredRequestCompleted（kmdf），DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf），RequestCompleted（kmdf），RequestCompletedLocal（kmdf） |