NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED, fonction (netadapter.h)

  • Article

La fonction NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED initialise une structure de 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 pilote et la pièce jointe.

Syntaxe

void NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES      *RxCapabilities,
  [_In_]  PFN_NET_ADAPTER_RETURN_RX_BUFFER EvtAdapterReturnRxBuffer,
  [_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_] EvtAdapterReturnRxBuffer

Pointeur vers la fonction de rappel EVT_NET_ADAPTER_RETURN_RX_BUFFER du pilote client. Pour plus d'informations, consultez la section Notes.

[_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_DRIVER_MANAGED pour initialiser sa structure NET_ADAPTER_RX_CAPABILITIES s’il souhaite effectuer manuellement l’allocation de mémoire tampon de réception et la pièce jointe. En appelant cette fonction, le membre AllocationMode de la structure de fonctionnalités Rx est défini sur NetRxFragmentBufferAllocationModeDriver et le membre AttachmentMode est défini sur NetRxFragmentBufferAttachmentModeDriver. Dans ce cas, il doit également fournir un pointeur vers sa fonction de rappel EVT_NET_ADAPTER_RETURN_RX_BUFFER dans la structure pour que le système d’exploitation appelle une fois que le système a terminé avec la mémoire tampon de réception.

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_SYSTEM_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA