Funzione NdisIfGetNetLuidFromInterfaceIndex (ndis.h)

Articolo
08/07/2023

La funzione NdisIfGetNetLuidFromInterfaceIndex ottiene il valore NET_LUID associato a un indice dell'interfaccia di rete.

Sintassi

NDIS_STATUS NdisIfGetNetLuidFromInterfaceIndex(
        NET_IFINDEX ifIndex,
  [out] PNET_LUID   pNetLuid
);

Parametri

ifIndex

Indice dell'interfaccia di rete assegnato da NDIS a un valore NET_LUID nel Funzione NdisIfRegisterInterface .

[out] pNetLuid

Puntatore a una variabile NET_LUID fornita dal chiamante. Se NdisIfGetNetLuidFromInterfaceIndex ha esito positivo, NDIS scrive il valore NET_LUID associato all'indice dell'interfaccia di rete specificato in questa variabile.

Valore restituito

NdisIfGetNetLuidFromInterfaceIndex restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	Operazione riuscita.
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfGetNetLuidFromInterfaceIndex non riuscito perché l'indice dell'interfaccia di rete specificato non è assegnato a un'interfaccia registrata.

Commenti

I driver NDIS possono chiamare la funzione NdisIfGetNetLuidFromInterfaceIndex per ottenere il valore NET_LUID associato a un indice dell'interfaccia di rete.

Per le interfacce gestite dal servizio provider proxy NDIS, NDIS fornisce l'indice di interfaccia e NET_LUID in varie strutture di inizializzazione del driver:

I driver Miniport possono ottenere l'indice di interfaccia e NET_LUID per un adattatore miniport nel NDIS_MINIPORT_INIT_PARAMETERS struttura.
I driver di filtro possono ottenere l'indice dell'interfaccia e NET_LUID per un modulo di filtro nel NDIS_FILTER_ATTACH_PARAMETERS struttura.
I driver di protocollo possono ottenere l'indice di interfaccia e NET_LUID delle interfacce più alte e inferiori in uno stack di driver nella struttura NDIS_BIND_PARAMETERS .

NDIS assegna un indice di interfaccia a un'interfaccia di rete quando il provider di interfaccia chiama la funzione NdisIfRegisterInterface . Un provider di interfaccia chiama la macro NDIS_MAKE_NET_LUID per creare il valore NET_LUID prima di registrare un'interfaccia.

Il valore dell'indice dell'interfaccia può cambiare senza riavviare il computer. La registrazione e la ripetizione della registrazione di un'interfaccia associata a un valore NET_LUID potrebbero comportare valori di indice di interfaccia diversi. Non confondere l'indice dell'interfaccia con l'indice NET_LUID che persiste dopo il riavvio di un computer.

NDIS fornisce Funzione NdisIfGetInterfaceIndexFromNetLuid per ottenere l'indice di interfaccia per un NET_LUID specificato.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (include Ndis.h)
Libreria	Ndis.lib
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	Irql_Interfaces_Function(ndis)