fonction NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA (netadapter.h)
La fonction NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA initialise une structure de NET_ADAPTER_TX_CAPABILITIES pour une carte réseau qui a spécifié l’utilisation de DMA dans son chemin de transmission de données.
Syntaxe
void NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA(
[_Out_] NET_ADAPTER_TX_CAPABILITIES *TxCapabilities,
[_In_] NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities,
[_In_] SIZE_T MaximumNumberOfQueues
);
Paramètres
[_Out_] TxCapabilities
Pointeur vers une structure de NET_ADAPTER_TX_CAPABILITIES allouée par le pilote.
[_In_] DmaCapabilities
Pointeur vers une structure de NET_ADAPTER_DMA_CAPABILITIES allouée et initialisée par un pilote.
[_In_] MaximumNumberOfQueues
Nombre maximal de files d’attente de transmission que l’adaptateur prend en charge.
Valeur de retour
None
Remarques
Cette fonction est l’une des deux fonctions possibles à appeler afin d’initialiser une structure NET_ADAPTER_TX_CAPABILITIES . Celle que le pilote client doit appeler dépend de l’utilisation ou non de DMA. NET_ADAPTER_TX_CAPABILITIES_INIT est utilisé si le pilote ne spécifie pas de mappage de mémoire DMA pour ses mémoires tampons de transmission, et NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA est utilisé si c’est le cas.
Avant d’appeler NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA, le pilote doit avoir alloué une structure de 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_TX_CAPABILITIES .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1,25 |
| En-tête | netadapter.h (inclure netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |