fonction NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA (netadapter.h)
La fonction NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA initialise une structure NET_ADAPTER_TX_CAPABILITIES pour une carte réseau qui a spécifié l’utilisation de DMA dans son chemin de transmission des 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 NET_ADAPTER_TX_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_] MaximumNumberOfQueues
Nombre maximal de files d’attente de transmission que l’adaptateur prend en charge.
Valeur de retour
Aucun
Remarques
Cette fonction est l’une des deux fonctions possibles à appeler pour initialiser une structure NET_ADAPTER_TX_CAPABILITIES. L’un des pilotes clients à appeler dépend du fait qu’il souhaite utiliser 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é s’il le fait.
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 à la DmaCapabilities membre de la structure NET_ADAPTER_TX_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 |