[仅适用于 KMDF]
WdfDmaEnablerWdmGetDmaAdapter 方法返回指向与 DMA 启用器对象关联的 WDM DMA_ADAPTER 结构的指针。
语法
PDMA_ADAPTER WdfDmaEnablerWdmGetDmaAdapter(
[in] WDFDMAENABLER DmaEnabler,
[in] WDF_DMA_DIRECTION DmaDirection
);
参数
[in] DmaEnabler
驱动程序从上一次调用 WdfDmaEnablerCreate获取的 DMA 启用器对象的句柄。
[in] DmaDirection
指定 DMA 传输作方向的 WDF_DMA_DIRECTION类型值。 有关详细信息，请参阅以下“备注”部分。
返回值
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） |
| 图书馆 | Wdf01000.sys（请参阅框架库版本控制。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI 符合性规则 | DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf） |