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 结构。 如果驱动程序未指定双工配置文件,驱动程序可以指定 WdfDmaDirectionReadFromDeviceWdfDmaDirectionWriteToDevice

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
Header 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