NetDmaGetVersion, fonction (netdma.h)

Remarque 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 principaux et secondaires comme suit :

Retourner le code	Description
haut 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 le MajorVersion et les membres minorVersion du NET_DMA_PROVIDER_CHARACTERISTICS structure qu’elle passe à la fonction NetDmaRegisterProvider.

RemarquenetDmaGetVersion n’est pas disponible dans NetDMA version 1.0. Pour éviter d’utiliser une importation de fonction qui peut empêcher le chargement du pilote, un pilote de fournisseur NetDMA 1.1 ou ultérieur doit vérifier la présence d'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 NdisGetRoutineAddress fourni. 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Pris en charge pour les pilotes NetDMA 2.0 et NetDMA 1.1 dans Windows Server 2008.
plateforme cible	Universel
d’en-tête	netdma.h (include Netdma.h)
IRQL	PASSIVE_LEVEL

Voir aussi

NET_DMA_PROVIDER_CHARACTERISTICS

NdisGetRoutineAddress

netDmaRegisterProvider