Funzione NdisIfGetInterfaceIndexFromNetLuid (ndis.h)

Articolo
02/07/2025

La funzione NdisIfGetInterfaceIndexFromNetLuid ottiene l'indice dell'interfaccia di rete associato a un valore NET_LUID.

Sintassi

NDIS_STATUS NdisIfGetInterfaceIndexFromNetLuid(
  [in]  NET_LUID     NetLuid,
  [out] PNET_IFINDEX pIfIndex
);

Parametri

[in] NetLuid

Valore NET_LUID che identifica un'interfaccia di rete.

[out] pIfIndex

Puntatore a una variabile di indice dell'interfaccia fornita dal chiamante. Se NdisIfGetInterfaceIndexFromNetLuid ha esito positivo, NDIS scrive l'indice dell'interfaccia di rete associato al NET_LUID specificato in questa variabile.

Valore restituito

NdisIfGetInterfaceIndexFromNetLuid restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	Operazione completata correttamente.
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfGetInterfaceIndexFromNetLuid non riuscito perché il NET_LUID specificato non era presente nell'elenco delle interfacce registrate.

Osservazioni

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

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

I driver Miniport possono ottenere l'indice dell'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 dell'interfaccia e NET_LUID delle interfacce più alte e più basse 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 interfacce 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 un riavvio del computer. La registrazione e la ripetizione della registrazione di un'interfaccia associata a un valore NET_LUID possono 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 NdisIfGetNetLuidFromInterfaceIndex per ottenere il valore NET_LUID associato a un indice di interfaccia specificato.

Fabbisogno

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)