Funzione NdisQueryAdapterInstanceName (ndis.h)

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

Sintassi

NDIS_STATUS NdisQueryAdapterInstanceName(
       PNDIS_STRING pAdapterInstanceName,
  [in] NDIS_HANDLE  NdisBindingHandle
);

Parametri

pAdapterInstanceName

Puntatore a un tipo di NDIS_STRING fornito dal chiamante che riceve una stringa Unicode con 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 Windows 2000 e versioni successive, NDIS definisce il tipo di NDIS_STRING come tipo di UNICODE_STRING .

[in] NdisBindingHandle

Handle che identifica l'associazione alla scheda di interfaccia di rete fisica di destinazione o alla scheda virtuale del driver inferiore successivo a cui è associato il chiamante. In genere , NdisBindingHandle è stato restituito dalla funzione NdisOpenAdapterEx .

Valore restituito

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

Commenti

Un driver di protocollo usa NdisQueryAdapterInstanceName per recuperare il nome descrittivo di una scheda di interfaccia di rete fisica o di una scheda virtuale a cui è associato il driver del protocollo. Il driver di protocollo specifica l'handle per tale scheda di interfaccia di rete o scheda virtuale in NdisBindingHandle . Il driver del protocollo chiama la funzione NdisOpenAdapterEx per recuperare questo handle.

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

I nomi descrittivi sono progettati per aiutare l'utente a identificare in modo rapido e accurato una scheda di interfaccia di rete fisica o una scheda virtuale, ad esempio "PCI Ethernet Adapter" 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 NdisQueryAdapterInstanceName (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisQueryAdapterInstanceName (NDIS 5.1)) in Windows XP.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (include Ndis.h)
Libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	Irql_Miscellaneous_Function(ndis)

Vedi anche

NdisFreeMemory

NdisOpenAdapterEx

UNICODE_STRING