Funzione NdisMQueryAdapterInstanceName (ndis.h)
La funzione NdisMQueryAdapterInstanceName recupera il nome descrittivo di un adattatore miniport.
Sintassi
NDIS_STATUS NdisMQueryAdapterInstanceName(
PNDIS_STRING pAdapterInstanceName,
NDIS_HANDLE MiniportHandle
);
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 per l'adattatore miniport specificato. Per Windows Vista e versioni successive del sistema operativo Windows, NDIS definisce il tipo di NDIS_STRING come tipo UNICODE_STRING.
MiniportHandle
Handle per l'adattatore miniport precedentemente inserito nell'oggetto funzione miniportInitializeEx.
Valore restituito
Restituisce NDIS_STATUS_SUCCESS se la memoria per la stringa in AdapterInstanceName è stata allocata correttamente; in caso contrario, restituisce NDIS_STATUS_RESOURCES.
Osservazioni
Un driver miniport usa NdisMQueryAdapterInstanceName per recuperare il nome descrittivo di un'interfaccia che il driver miniport controlla. Questa interfaccia è una scheda di interfaccia di rete fisica o una scheda virtuale e viene chiamata scheda miniport . Il driver miniport specifica l'handle di un adattatore miniport in MiniportAdapterHandle . Questo handle alla scheda miniport viene passato alla funzione miniportInitializeEx per configurare la scheda miniport per le operazioni di I/O di rete.
NdisMQueryAdapterInstanceName alloca memoria per la stringa che specifica il nome descrittivo. Al termine dell'utilizzo della memoria da parte del chiamante, 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.