fonction NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED (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 et la pièce jointe de réception gérées par le pilote.
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 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 Remarques.
[_In_] MaximumFrameSize
Taille maximale du frame, 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
Aucun
Remarques
Cette fonction est l’une des trois fonctions possibles à appeler pour initialiser une structure NET_ADAPTER_RX_CAPABILITIES. L’un des pilotes clients à appeler dépend de la façon dont il souhaite allouer des 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 de NET_ADAPTER_RX_CAPABILITIES s’il souhaite effectuer une allocation et une pièce jointe de réception manuelles de la mémoire tampon. En appelant cette fonction, le membre AllocationMode de la structure des fonctionnalités Rx a la valeur 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 du système d’exploitation à appeler une fois le système terminé avec la mémoire tampon de réception.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.25 |
| version minimale de UMDF | 2.33 |
| d’en-tête | netadapter.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |