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 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 NDIS_STRING en tant que type UNICODE_STRING.
MiniportHandle
Handle de l’adaptateur miniport qui a été précédemment entré dans le fonction MiniportInitializeEx.
Valeur de retour
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 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, appelée adaptateur miniport. Le pilote miniport spécifie la poignée d’un adaptateur miniport dans MiniportAdapterHandle . Cette poignée à la carte miniport est transmise à la fonction miniport MiniportInitializeEx 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 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.