fonction NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA (netadapter.h)

La fonction NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA initialise une structure NET_ADAPTER_RX_CAPABILITIES pour une carte réseau qui souhaite spécifier l’allocation de mémoire tampon de réception gérée par le système d’exploitation et la pièce jointe, ainsi que DMA pour le mappage de mémoire.

Syntaxe

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES  *RxCapabilities,
  [_In_]  NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities,
  [_In_]  SIZE_T                       MaximumFrameSize,
  [_In_]  SIZE_T                       MaximumNumberOfQueues
);

Paramètres

[_Out_] RxCapabilities

Pointeur vers une structure de NET_ADAPTER_RX_CAPABILITIES allouée par le pilote.

[_In_] DmaCapabilities

Pointeur vers une structure de NET_ADAPTER_DMA_CAPABILITIES allouée et initialisée par un pilote.

[_In_] MaximumFrameSize

Taille d’image maximale, en octets, que l’adaptateur peut recevoir.

[_In_] MaximumNumberOfQueues

Nombre maximal de files d’attente de réception que l’adaptateur prend en charge.

Valeur de retour

None

Remarques

Cette fonction est l’une des trois fonctions possibles à appeler afin d’initialiser une structure NET_ADAPTER_RX_CAPABILITIES . Celui que le pilote client doit appeler dépend de la façon dont il souhaite allouer les mémoires tampons de réception et s’il souhaite utiliser DMA.

Le pilote client doit appeler NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA pour initialiser sa structure de NET_ADAPTER_RX_CAPABILITIES s’il souhaite que le système d’exploitation effectue l’allocation de mémoire tampon et la pièce jointe de réception, et s’il souhaite également utiliser DMA dans son chemin de réception des données. En appelant cette fonction, le membre AllocationMode de la structure de fonctionnalités Rx est défini sur NetRxFragmentBufferAllocationModeSystem et le membre AttachmentMode est défini sur NetRxFragmentBufferAttachmentModeSystem.

Avant d’appeler NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA, le pilote doit avoir alloué une structure de NET_ADAPTER_DMA_CAPABILITIES et l’initialiser avec NET_ADAPTER_DMA_CAPABILITIES_INIT. Cette structure de fonctionnalités DMA est ensuite affectée au membre DmaCapabilities de la structure NET_ADAPTER_RX_CAPABILITIES .

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1,25
En-tête netadapter.h (inclure netadaptercx.h)
IRQL PASSIVE_LEVEL

Voir aussi

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED