Funzione NdisIfGetInterfaceIndexFromNetLuid (ndis.h)

Articolo
02/26/2024

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 alla NET_LUID specificata in questa variabile.

Valore restituito

NdisIfGetInterfaceIndexFromNetLuid restituisce uno dei valori di stato seguenti:

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

Commenti

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 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 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 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 NdisIfGetNetLuidFromInterfaceIndex per ottenere il valore NET_LUID associato a un indice di interfaccia 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)