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) |