NdisQueryAdapterInstanceName, fonction (ndis.h)

  • Article

La fonction NdisQueryAdapterInstanceName récupère le nom convivial d’une carte réseau physique ou d’une carte virtuelle à laquelle le pilote de protocole appelant est lié.

Syntaxe

NDIS_STATUS NdisQueryAdapterInstanceName(
       PNDIS_STRING pAdapterInstanceName,
  [in] NDIS_HANDLE  NdisBindingHandle
);

Paramètres

pAdapterInstanceName

Pointeur vers un type NDIS_STRING fourni par l’appelant qui reçoit une chaîne Unicode comptée. Cette chaîne spécifie le nom convivial de l’interface à laquelle la liaison fait référence. Cette interface est une carte réseau physique ou une carte virtuelle. Pour Windows 2000 et versions ultérieures, NDIS définit le type NDIS_STRING comme un type UNICODE_STRING .

[in] NdisBindingHandle

Handle qui identifie la liaison à la carte réseau physique ou à l’adaptateur virtuel cible du pilote inférieur suivant auquel l’appelant est lié. En règle générale, NdisBindingHandle a été retourné par la fonction NdisOpenAdapterEx .

Valeur retournée

NdisQueryAdapterInstanceName retourne NDIS_STATUS_SUCCESS si la mémoire de la chaîne à AdapterInstanceName a été correctement allouée ; sinon, il retourne NDIS_STATUS_RESOURCES.

Remarques

Un pilote de protocole utilise NdisQueryAdapterInstanceName pour récupérer le nom convivial d’une carte réseau physique ou d’une carte virtuelle à laquelle le pilote de protocole est lié. Le pilote de protocole spécifie le handle d’une carte réseau ou d’une carte virtuelle de ce type dans NdisBindingHandle . Le pilote de protocole appelle la fonction NdisOpenAdapterEx pour récupérer ce handle.

NdisQueryAdapterInstanceName alloue de la mémoire pour la chaîne qui spécifie le nom convivial. Une fois que l’appelant a terminé d’utiliser cette mémoire, l’appelant doit appeler la fonction NdisFreeMemory pour libérer la mémoire.

Les noms conviviaux sont destinés à aider l’utilisateur à identifier rapidement et précisément une carte réseau physique ou une carte virtuelle. Par exemple, « adaptateur Ethernet PCI » et « adaptateur réseau privé virtuel » sont considérés comme des noms conviviaux.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (consultez NdisQueryAdapterInstanceName (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (consultez NdisQueryAdapterInstanceName (NDIS 5.1)) dans Windows XP.
Plateforme cible Desktop (Expérience utilisateur)
En-tête ndis.h (inclure Ndis.h)
Bibliothèque Ndis.lib
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI Irql_Miscellaneous_Function(ndis)

Voir aussi

NdisFreeMemory

NdisOpenAdapterEx

UNICODE_STRING