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