NdisMQueryAdapterInstanceName, fonction (ndis.h)
La fonction NdisMQueryAdapterInstanceName récupère le nom convivial d’un adaptateur miniport.
Syntaxe
NDIS_STATUS NdisMQueryAdapterInstanceName(
PNDIS_STRING pAdapterInstanceName,
NDIS_HANDLE MiniportHandle
);
Paramètres
pAdapterInstanceName
Pointeur vers un type de 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 pour l’adaptateur miniport donné. Pour Windows Vista et les versions ultérieures du système d’exploitation Windows, NDIS définit le type de NDIS_STRING en tant que type UNICODE_STRING .
MiniportHandle
Poignée de l’adaptateur miniport qui a été précédemment entré dans le Fonction MiniportInitializeEx .
Valeur retournée
Retourne NDIS_STATUS_SUCCESS si la mémoire de la chaîne dans AdapterInstanceName a été correctement allouée ; sinon, elle retourne NDIS_STATUS_RESOURCES.
Remarques
Un pilote miniport utilise NdisMQueryAdapterInstanceName pour récupérer le nom convivial d’une interface que le pilote miniport contrôle. Cette interface est une carte réseau physique ou une carte virtuelle et est appelée adaptateur miniport. Le pilote miniport spécifie la poignée d’un adaptateur miniport dans MiniportAdapterHandle . Cette poignée de l’adaptateur miniport est passée à la fonction MiniportInitializeEx du pilote miniport pour configurer la carte miniport pour les opérations d’E/S réseau.
NdisMQueryAdapterInstanceName 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 avec précision une carte réseau physique ou une carte virtuelle. Par exemple, « Carte Ethernet PCI » et « Carte réseau privée virtuelle » sont considérés comme des noms conviviaux.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge dans NDIS 5.1 et NDIS 6.0 et versions ultérieures. Pour les pilotes NDIS 5.1, consultez NdisMQueryAdapterInstanceName (NDIS 5.1). |
| Plateforme cible | Universal |
| En-tête | ndis.h (inclure Ndis.h) |
| Bibliothèque | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | Irql_Miniport_Driver_Function(ndis) |