NdisQueryBindInstanceName, fonction (ndis.h)

La fonction NdisQueryBindInstanceName 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 NdisQueryBindInstanceName(
  [out] PNDIS_STRING pAdapterInstanceName,
  [in]  NDIS_HANDLE  BindingContext
);

Paramètres

[out] 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 les systèmes d’exploitation Microsoft Windows 2000 et versions ultérieures, NDIS définit le type NDIS_STRING en tant que type UNICODE_STRING.

[in] BindingContext

Handle qui identifie la zone de contexte NDIS pour l’opération de liaison. NDIS a passé ce handle au paramètre BindContext du Fonction ProtocolBindAdapterEx.

Valeur de retour

NdisQueryBindInstanceName retourne NDIS_STATUS_SUCCESS si la mémoire de la chaîne à pAdapterInstanceName a été correctement allouée ; sinon, elle retourne NDIS_STATUS_RESOURCES.

Remarques

Un pilote de protocole utilise NdisQueryBindInstanceName pour récupérer le nom convivial d’une carte réseau physique ou d’une carte virtuelle à laquelle le pilote de protocole sera lié. Le pilote de protocole spécifie le contexte de liaison fourni par NDIS dans le Fonction ProtocolBindAdapterEx.

Les pilotes de protocole peuvent utiliser NdisQueryBindInstanceName pour obtenir le nom convivial avant de les lier à l’adaptateur.

NdisQueryBindInstanceName 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.

Exigences

Voir aussi

NdisFreeMemory

ProtocolBindAdapterEx

UNICODE_STRING