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 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 à 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 ultérieur, NDIS définit le type de 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 retournée

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 se lier à l’adaptateur.

NdisQueryBindInstanceName 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

NdisFreeMemory

ProtocolBindAdapterEx

UNICODE_STRING