NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED, fonction (netadapter.h)

La fonction NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED initialise une structure de NET_ADAPTER_RX_CAPABILITIES pour une carte réseau qui souhaite spécifier l’allocation et la pièce jointe de mémoires tampons de réception gérées par le système d’exploitation, mais pas l’utilisation du mappage de mémoire DMA.

Syntaxe

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES *RxCapabilities,
  [_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_] 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 pour 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 pour initialiser sa structure 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, mais ne nécessite pas de mappage de mémoire DMA. 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. Étant donné que le pilote ne spécifie pas de fonctionnalités DMA dans ce cas, cette fonction définit également le membre MappingRequirement sur NetMemoryMappingRequirementNone.

Configuration requise

Voir aussi

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA