Funzione NdisIfQueryBindingIfIndex (ndis.h)

Articolo
02/29/2024

La funzione NdisIfQueryBindingIfIndex recupera gli indici dell'interfaccia di rete e i valori NET_LUID per le interfacce di rete più alte e più basse associate a un'associazione di protocollo specificata.

Sintassi

NDIS_STATUS NdisIfQueryBindingIfIndex(
  [in]  NDIS_HANDLE  NdisBindingHandle,
  [out] PNET_IFINDEX pBoundIfIndex,
  [out] PNET_LUID    pBoundIfNetLuid,
  [out] PNET_IFINDEX pLowestIfIndex,
  [out] PNET_LUID    pLowestIfNetLuid
);

Parametri

[in] NdisBindingHandle

Handle che identifica l'associazione per cui NDIS deve ottenere i valori di NET_LUID e gli indici dell'interfaccia di rete. NDIS ha fornito questo handle al parametro NdisBindingHandle della funzione NdisOpenAdapterEx .

[out] pBoundIfIndex

Puntatore a una variabile di indice dell'interfaccia fornita dal chiamante. Se NdisIfQueryBindingIfIndex riesce, NDIS scrive in questa variabile l'indice dell'interfaccia di rete dell'interfaccia di rete associata all'associazione specificata ed è più alto nello stack di driver.

[out] pBoundIfNetLuid

Puntatore a una variabile NET_LUID fornita dal chiamante. Se NdisIfQueryBindingIfIndex riesce, NDIS scrive in questa variabile il valore NET_LUID dell'interfaccia di rete associata all'associazione specificata ed è più alto nello stack di driver.

[out] pLowestIfIndex

Puntatore a una variabile di indice dell'interfaccia fornita dal chiamante. Se NdisIfQueryBindingIfIndex riesce, NDIS scrive in questa variabile l'indice dell'interfaccia di rete dell'interfaccia di rete associato all'associazione specificata ed è più basso nello stack di driver.

[out] pLowestIfNetLuid

Puntatore a una variabile NET_LUID fornita dal chiamante. Se NdisIfQueryBindingIfIndex riesce, NDIS scrive in questa variabile il valore NET_LUID dell'interfaccia di rete associato all'associazione specificata ed è più basso nello stack di driver.

Valore restituito

NdisIfQueryBindingIfIndex restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	Operazione riuscita.
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfQueryBindingIfIndex non è riuscito perché l'associazione specificata non è associata a un'interfaccia registrata.

Commenti

I driver del protocollo NDIS possono chiamare la funzione NdisIfQueryBindingIfIndex per recuperare gli indici dell'interfaccia di rete e NET_LUID valori associati a un'associazione.

NdisIfQueryBindingIfIndex fornisce il valore NET_LUID e l'indice dell'interfaccia per l'interfaccia più alta e l'interfaccia più bassa associata all'associazione. Questi valori sono diversi, ad esempio, se l'adattatore miniport direttamente associato all'associazione specificata è il miniport virtuale di un driver intermedio di filtro o se è presente un modulo di filtro configurato tramite l'adattatore miniport.

I driver di protocollo possono anche 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 .

Requisiti

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

Vedi anche

NDIS_BIND_PARAMETERS

NET_LUID

NdisOpenAdapterEx

Condividi tramite