Fonction NetDmaGetVersion (netdma.h)

Note L’interface NetDMA n’est pas prise en charge

dans Windows 8 et versions ultérieures.

 

La fonction NetDmaGetVersion retourne la version de l’interface NetDMA prise en charge par l’ordinateur local.

Syntaxe

NET_DMA_EXPORT UINT NetDmaGetVersion();

Valeur de retour

NetDmaGetVersion retourne une valeur UINT qui contient les numéros de version principale et secondaire comme suit :

Code de retour	Description
Haute 16 bits	Numéro de version principal de l’interface NetDMA.
Faible 16 bits	Version mineure de l’interface NetDMA.

Remarques

Les pilotes de fournisseur NetDMA peuvent appeler la fonction NetDmaGetVersion pour obtenir la version de l’interface NetDMA. Un fournisseur NetDMA doit s’inscrire en tant que fournisseur NetDMA avec une version égale ou inférieure à la version de l’interface du fournisseur NetDMA prise en charge par l’ordinateur local. Le pilote du fournisseur NetDMA spécifie la version principale et mineure du fournisseur NetDMA dans les membres MajorVersion et MinorVersion du NET_DMA_PROVIDER_CHARACTERISTICS structure qu’il transmet au Fonction NetDmaRegisterProvider .

RemarqueNetDmaGetVersion n’est pas disponible dans NetDMA version 1.0. Pour éviter d’utiliser une importation de fonction susceptible d’empêcher le chargement du pilote, un pilote de fournisseur NetDMA 1.1 ou version ultérieure doit vérifier la présence de NetDmaGetVersion avant d’appeler NetDmaGetVersion. Pour appeler NetDmaGetVersion, appelez d’abord la fonction NdisGetRoutineAddress pour obtenir le point d’entrée, puis, si NetDmaGetVersion est disponible, appelez NetDmaGetVersion au point d’entrée fourni par NdisGetRoutineAddress . Si le pilote du fournisseur ne peut pas obtenir l’adresse de NetDmaGetVersion, l’interface NetDMA prise en charge doit être la version 1.0.

 

Les pilotes du fournisseur NetDMA appellent NetDmaGetVersion à IRQL = PASSIVE_LEVEL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes NetDMA 2.0 et NetDMA 1.1 dans Windows Server 2008.
Plateforme cible	Universal
En-tête	netdma.h (inclure Netdma.h)
IRQL	PASSIVE_LEVEL

Voir aussi

NET_DMA_PROVIDER_CHARACTERISTICS

NdisGetRoutineAddress

NetDmaRegisterProvider