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 che in precedenza era input per il 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.
Commenti
Un driver miniport usa NdisMQueryAdapterInstanceName per recuperare il nome descrittivo di un'interfaccia che controlla il driver miniport. Questa interfaccia è una scheda di interfaccia di rete fisica o una scheda virtuale e viene chiamata scheda miniport. Il driver miniport specifica l'handle per un adattatore miniport in MiniportAdapterHandle . Questo handle alla scheda miniport viene passato alla funzione MiniportInitializeEx del driver miniport 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'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 in NDIS 5.1 e NDIS 6.0 e versioni successive. Per i driver NDIS 5.1, vedere NdisMQueryAdapterInstanceName (NDIS 5.1). |
Piattaforma di destinazione | Universale |
Intestazione | ndis.h (include Ndis.h) |
Libreria | Ndis.lib |
IRQL | PASSIVE_LEVEL |
Regole di conformità DDI | Irql_Miniport_Driver_Function(ndis) |