NdisQueryAdapterInstanceName, fonction (ndis.h)
La fonction NdisQueryAdapterInstanceName récupère le nom convivial d’une carte réseau physique ou d’une carte virtuelle auquel 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 en tant que 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 de retour
NdisQueryAdapterInstanceName retourne NDIS_STATUS_SUCCESS si la mémoire de la chaîne à AdapterInstanceName a été correctement allouée ; sinon, elle 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 sur une carte réseau ou 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 l’appelant terminé à l’aide de 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 « Carte réseau privée virtuelle » sont considérés comme des noms conviviaux.