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

Voir aussi

MiniportInitializeEx

NdisFreeMemory

UNICODE_STRING