fonction NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA (netadapter.h)
La fonction NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA 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 système d’exploitation, 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 NET_ADAPTER_RX_CAPABILITIES allouée par le pilote.
[_In_] DmaCapabilities
Pointeur vers une structure NET_ADAPTER_DMA_CAPABILITIESNET_ADAPTER_DMA_CAPABILITIES allouée par le pilote.
[_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_SYSTEM_MANAGED_DMA pour initialiser sa structure de NET_ADAPTER_RX_CAPABILITIES s’il souhaite que le système d’exploitation effectue l’allocation et la pièce jointe de la mémoire tampon de réception, et s’il souhaite également utiliser DMA dans son chemin de données de réception. 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 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.25 |
| d’en-tête | netadapter.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |