structure NET_DMA_PROVIDER_CHARACTERISTICS (netdma.h)

Article
08/07/2023

Note L’interface NetDMA n’est pas prise en charge dans Windows 8 et versions ultérieures.

La structure NET_DMA_PROVIDER_CHARACTERISTICS spécifie les caractéristiques d’un fournisseur NetDMA, y compris les points d’entrée des fonctions ProviderXxx .

Syntaxe

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;

Membres

MajorVersion

Numéro de version principale du pilote du fournisseur DMA.

MinorVersion

Numéro de version secondaire du pilote du fournisseur DMA.

Size

Taille, en octets, de cette structure NET_DMA_PROVIDER_CHARACTERISTICS. Définissez ce membre sur sizeof(NET_DMA_PROVIDER_CHARACTERISTICS).

Flags

Indicateurs des caractéristiques du fournisseur DMA. Les pilotes NetDMA 1.0 et 1.1 définissent ce membre sur zéro.

Les pilotes NetDMA 2.0 et versions ultérieures peuvent utiliser les indicateurs suivants.

NET_DMA_PROVIDER_CHARACTERISTICS_DCA_SUPPORTED

Le fournisseur NetDMA prend en charge l’accès direct au cache (DCA).

PhysicalDeviceObject

Objet de périphérique physique (PDO) associé au fournisseur DMA. Le gestionnaire Plug-and-Play (PnP) fournit un pointeur vers l’AOP au niveau du paramètre PhysicalDeviceObject vers la routine AddDevice.

MaxDmaChannelCount

Nombre maximal de canaux DMA que le fournisseur DMA peut prendre en charge.

SetDmaChannelCpuAffinity

Point d’entrée pour le Fonction ProviderSetDmaChannelCpuAffinity .

AllocateDmaChannel

Point d’entrée pour le Fonction ProviderAllocateDmaChannel .

FreeDmaChannel

Point d’entrée pour le Fonction ProviderFreeDmaChannel .

StartDma

Point d’entrée de la fonction ProviderStartDma .

SuspendDma

Point d’entrée de la fonction ProviderSuspendDma . Si cette fonction n’est pas prise en charge, définissez ce membre sur NULL.

ResumeDma

Point d’entrée de la fonction ProviderResumeDma . Si cette fonction n’est pas prise en charge, définissez ce membre sur NULL.

AbortDma

Point d’entrée de la fonction ProviderAbortDma . Si cette fonction n’est pas prise en charge, définissez ce membre sur NULL.

AppendDma

Point d’entrée de la fonction ProviderAppendDma .

ResetChannel

Point d’entrée de la fonction ProviderResetChannel . Si cette fonction n’est pas prise en charge, définissez ce membre sur NULL.

FriendlyName

Chaîne Unicode qui représente la description lisible par l’utilisateur du pilote du fournisseur NetDMA.

Remarques

Pour inscrire un fournisseur DMA, un pilote de fournisseur DMA appelle la fonction NetDmaRegisterProvider à partir de sa routine AddDevice .

Le pilote du fournisseur DMA fournit une structure NET_DMA_PROVIDER_CHARACTERISTICS au paramètre ProviderCharacteristics de NetDmaRegisterProvider.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes NetDMA 2.0 dans Windows Server 2008. (Membre FriendlyName ajouté.) Pris en charge pour les pilotes NetDMA 1.1 dans Windows Server 2008. Pris en charge pour les pilotes NetDMA 1.0 dans Windows Server 2008 et Windows Vista.
En-tête	netdma.h (inclure Netdma.h)