WdfDmaEnablerWdmGetDmaAdapter 函数 (wdfdmaenabler.h)

  • 项目

[仅适用于 KMDF]

WdfDmaEnablerWdmGetDmaAdapter 方法返回指向与 DMA 启用程序对象关联的 WDM DMA_ADAPTER 结构的指针。

语法

PDMA_ADAPTER WdfDmaEnablerWdmGetDmaAdapter(
  [in] WDFDMAENABLER     DmaEnabler,
  [in] WDF_DMA_DIRECTION DmaDirection
);

参数

[in] DmaEnabler

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

[in] DmaDirection

一个WDF_DMA_DIRECTION类型的值，该值指定 DMA 传输操作的方向。 有关更多信息，请参见下面的“备注”部分。

返回值

WdfDmaEnablerWdmGetDmaAdapter 返回指向DMA_ADAPTER结构的指针;如果 DmaDirection 参数的值无效，则返回 NULL。

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

注解

当驱动程序调用 WdfDmaEnablerCreate 时，如果驱动程序指定双工配置文件，框架将为每个方向创建单独的 适配器对象 ;如果驱动程序未指定双工配置文件，框架将创建单个适配器对象。

如果驱动程序在调用 WdfDmaEnablerCreate 时指定了双工配置文件， 则 WdfDmaEnablerWdmGetDmaAdapter 方法的 DmaDirection 参数的值必须为 WdfDmaDirectionReadFromDevice 以获取读取操作 的DMA_ADAPTER 结构， WdfDmaDirectionWriteToDevice 以获取写入操作 的DMA_ADAPTER 结构。 如果驱动程序未指定双工配置文件，驱动程序可以指定 WdfDmaDirectionReadFromDevice 或 WdfDmaDirectionWriteToDevice。

WdfDmaEnablerWdmGetDmaAdapter 返回的指针在删除 DMA 启用程序对象之前有效。 如果驱动程序为 DMA 启用程序对象提供 EvtCleanupCallback 函数，则指针在回调函数返回之前有效。

示例

下面的代码示例创建一个 DMA 启用程序对象，然后获取指向框架为读取和写入操作创建的 WDM DMA_ADAPTER 结构的指针。

NTSTATUS  status = STATUS_SUCCESS;
WDF_DMA_ENABLER_CONFIG  dmaConfig;
WDFDMAENABLER  dmaEnabler;
PDMA_ADAPTER  readAdapter, writeAdapter;

WDF_DMA_ENABLER_CONFIG_INIT(
                            &dmaConfig,
                            WdfDmaProfileScatterGatherDuplex,
                            maxLength
                            );
status = WdfDmaEnablerCreate(
                             Device,
                             &dmaConfig,
                             WDF_NO_OBJECT_ATTRIBUTES,
                             &dmaEnabler
                             );
if (!NT_SUCCESS (status)) {
    return status;
}

readAdapter = WdfDmaEnablerWdmGetDmaAdapter(
                                            dmaEnabler,
                                            WdfDmaDirectionReadFromDevice
                                            );
writeAdapter = WdfDmaEnablerWdmGetDmaAdapter(
                                             dmaEnabler,
                                             WdfDmaDirectionWriteToDevice
                                             );

要求

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

另请参阅

DMA_ADAPTER

WDF_DMA_DIRECTION

WdfDmaEnablerCreate