netdma.h) (NET_DMA_PROVIDER_CHARACTERISTICS 结构
语法
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) |