netdma.h) (NET_DMA_PROVIDER_CHARACTERISTICS 结构

项目
02/29/2024

注意Windows 8 及更高版本中不支持 NetDMA 接口。

NET_DMA_PROVIDER_CHARACTERISTICS 结构指定 NetDMA 提供程序的特征，包括 ProviderXxx 函数的入口点。

语法

typedef struct _NET_DMA_PROVIDER_CHARACTERISTICS {
  UCHAR                             MajorVersion;
  UCHAR                             MinorVersion;
  USHORT                            Size;
  ULONG                             Flags;
  PDEVICE_OBJECT                    PhysicalDeviceObject;
  ULONG                             MaxDmaChannelCount;
  DMA_CHANNELS_CPU_AFFINITY_HANDLER SetDmaChannelCpuAffinity;
  DMA_CHANNEL_ALLOCATE_HANDLER      AllocateDmaChannel;
  DMA_CHANNEL_FREE_HANDLER          FreeDmaChannel;
  DMA_START_HANDLER                 StartDma;
  DMA_SUSPEND_HANDLER               SuspendDma;
  DMA_RESUME_HANDLER                ResumeDma;
  DMA_ABORT_HANDLER                 AbortDma;
  DMA_APPEND_HANDLER                AppendDma;
  DMA_RESET_HANDLER                 ResetChannel;
  UNICODE_STRING                    FriendlyName;
} NET_DMA_PROVIDER_CHARACTERISTICS, *PNET_DMA_PROVIDER_CHARACTERISTICS;

成员

MajorVersion

DMA 提供程序驱动程序的主版本号。

MinorVersion

DMA 提供程序驱动程序的次要版本号。

Size

此NET_DMA_PROVIDER_CHARACTERISTICS结构的大小（以字节为单位）。将此成员设置为 sizeof (NET_DMA_PROVIDER_CHARACTERISTICS) 。

Flags

DMA 提供程序特征标志。 NetDMA 1.0 和 1.1 驱动程序将此成员设置为零。

NetDMA 2.0 及更高版本的驱动程序可以使用以下标志。

NET_DMA_PROVIDER_CHARACTERISTICS_DCA_SUPPORTED

NetDMA 提供程序支持直接缓存访问 (DCA) 。

PhysicalDeviceObject

物理设备对象 (与 DMA 提供程序关联的 PDO) 。即插即用 (PnP) 管理器在 AddDevice 例程的 PhysicalDeviceObject 参数处提供指向 PDO 的指针。

MaxDmaChannelCount

DMA 提供程序可以支持的 DMA 通道的最大数目。

SetDmaChannelCpuAffinity

的入口点 ProviderSetDmaChannelCpuAffinity 函数。

AllocateDmaChannel

的入口点 ProviderAllocateDmaChannel 函数。

FreeDmaChannel

的入口点 ProviderFreeDmaChannel 函数。

StartDma

ProviderStartDma 函数的入口点。

SuspendDma

ProviderSuspendDma 函数的入口点。如果不支持此函数，请将此成员设置为 NULL。

ResumeDma

ProviderResumeDma 函数的入口点。如果不支持此函数，请将此成员设置为 NULL。

AbortDma

ProviderAbortDma 函数的入口点。如果不支持此函数，请将此成员设置为 NULL。

AppendDma

ProviderAppendDma 函数的入口点。

ResetChannel

ProviderResetChannel 函数的入口点。如果不支持此函数，请将此成员设置为 NULL。

FriendlyName

一个 Unicode 字符串，表示 NetDMA 提供程序驱动程序的用户可读说明。

注解

为了注册 DMA 提供程序，DMA 提供程序驱动程序从其 AddDevice 例程调用 NetDmaRegisterProvider 函数。

DMA 提供程序驱动程序在 NetDmaRegisterProvider 的 ProviderCharacteristics 参数中提供NET_DMA_PROVIDER_CHARACTERISTICS结构。

要求

要求	值
最低受支持的客户端	支持 Windows Server 2008 中的 NetDMA 2.0 驱动程序。 (添加了适用于 Windows Server 2008 中 NetDMA 1.1 驱动程序的 FriendlyName member.) 。支持 Windows Server 2008 和 Windows Vista 中的 NetDMA 1.0 驱动程序。
标头	netdma.h (包括 Netdma.h)