Funzione NdisQueryBindInstanceName (ndis.h)

La funzione NdisQueryBindInstanceName recupera il nome descrittivo di una scheda di interfaccia di rete fisica o di una scheda virtuale a cui verrà associato il driver del protocollo chiamante.

Sintassi

NDIS_STATUS NdisQueryBindInstanceName(
  [out] PNDIS_STRING pAdapterInstanceName,
  [in]  NDIS_HANDLE  BindingContext
);

Parametri

[out] pAdapterInstanceName

Puntatore a un tipo di NDIS_STRING fornito dal chiamante che riceve una stringa Unicode conteggiata. Questa stringa specifica il nome descrittivo dell'interfaccia a cui fa riferimento l'associazione. Questa interfaccia è una scheda di interfaccia di rete fisica o una scheda virtuale. Per i sistemi operativi Microsoft Windows 2000 e versioni successive, NDIS definisce il tipo NDIS_STRING come tipo UNICODE_STRING .

[in] BindingContext

Handle che identifica l'area del contesto NDIS per l'operazione di associazione. NDIS ha passato questo handle al parametro BindContext dell'oggetto Funzione ProtocolBindAdapterEx .

Valore restituito

NdisQueryBindInstanceName restituisce NDIS_STATUS_SUCCESS se la memoria per la stringa in pAdapterInstanceName è stata allocata correttamente; in caso contrario, restituisce NDIS_STATUS_RESOURCES.

Commenti

Un driver di protocollo usa NdisQueryBindInstanceName per recuperare il nome descrittivo di una scheda di interfaccia di rete fisica o di una scheda virtuale a cui verrà associato il driver del protocollo. Il driver del protocollo specifica il contesto di associazione fornito da NDIS nell'oggetto Funzione ProtocolBindAdapterEx .

I driver di protocollo possono usare NdisQueryBindInstanceName per ottenere il nome descrittivo prima di associarlo all'adapter.

NdisQueryBindInstanceName alloca memoria per la stringa che specifica il nome descrittivo. Al termine dell'uso di questa memoria, il chiamante deve chiamare la funzione NdisFreeMemory per rilasciare la memoria.

I nomi descrittivi sono destinati a aiutare l'utente a identificare rapidamente e accuratamente una scheda di interfaccia di rete fisica o una scheda di rete virtuale, ad esempio "Adattatore Ethernet PCI" e "Virtual Private Networking Adapter" sono considerati nomi descrittivi.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisQueryBindInstanceName (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisQueryBindInstanceName (NDIS 5.1) in Windows XP.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (includere Ndis.h)
Libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	NdisQueryBindInstanceName(ndis)

Vedi anche

NdisFreeMemory

ProtocolBindAdapterEx

UNICODE_STRING