netadapter.h) (NET_ADAPTER_DMA_CAPABILITIES 结构

NET_ADAPTER_DMA_CAPABILITIES结构描述 Net 适配器的 DMA 功能。

语法

typedef struct _NET_ADAPTER_DMA_CAPABILITIES {
  ULONG            Size;
  WDFDMAENABLER    DmaEnabler;
  PHYSICAL_ADDRESS MaximumPhysicalAddress;
  WDF_TRI_STATE    CacheEnabled;
  NODE_REQUIREMENT PreferredNode;
} NET_ADAPTER_DMA_CAPABILITIES;

成员

Size

此结构的大小(以字节为单位)。

DmaEnabler

客户端驱动程序用于映射和分配内存的 DMA 启用程序对象。

重要

使用 WDF_DMA_ENABLER_CONFIG 结构配置此对象时,客户端驱动程序必须将 WdmDmaVersionOverride 成员设置为 3 才能指定 DMA 版本 3。

MaximumPhysicalAddress

分配内存缓冲区时要使用的最大物理地址。 将此成员设置为 0 以指示没有最大地址。

CacheEnabled

一个WDF_TRI_STATE值,该值定义分配的内存是否应启用缓存。 如果此成员设置为 WdfDefault,则仅当设备缓存一致时,才会启用缓存。

PreferredNode

分配内存时要使用的首选 NUMA 节点。 如果此成员设置为 MM_ANY_NODE_OK,NetAdapterCx 将自动确定要使用的最佳节点。

注解

调用 NET_ADAPTER_DMA_CAPABILITIES_INIT 初始化此结构。

此结构既可以在接收路径中用作 NET_ADAPTER_RX_CAPABILITIES 结构的成员,也可以在传输路径中用作 NET_ADAPTER_TX_CAPABILITIES 结构的成员。

要求

要求
最低 KMDF 版本 1.27
标头 netadapter.h (包括 netadaptercx.h)

另请参阅

NET_ADAPTER_DMA_CAPABILITIES_INIT

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_TX_CAPABILITIES