NdisQueryAdapterInstanceName, fonction (ndis.h)
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) |