NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED, fonction (netadapter.h)
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 |
| Version UMDF minimale | 2,33 |
| En-tête | netadapter.h (inclure netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |