NET_DMA_PROVIDER_CHARACTERISTICS結構 (netdma.h)

發行項
02/26/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) 管理員會將實體DeviceObject 參數的 PDO 指標提供給 AddDevice 例程。

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)