Funzione NdisIfFreeNetLuidIndex (ndis.h)

  • Articolo

La funzione NdisIfFreeNetLuidIndex libera un'interfaccia di rete NET_LUID indice allocato in precedenza da una chiamata a . Funzione NdisIfAllocateNetLuidIndex .

Sintassi

NDIS_STATUS NdisIfFreeNetLuidIndex(
       NET_IFTYPE ifType,
  [in] UINT32     NetLuidIndex
);

Parametri

ifType

Tipo di interfaccia per cui è stato allocato l'indice. Il chiamante deve fornire lo stesso valore usato quando ha allocato l'indice NET_LUID con NdisIfAllocateNetLuidIndex. Per un elenco dei tipi di interfaccia, vedere Tipi di interfaccia NDIS.

[in] NetLuidIndex

Valore di indice NET_LUID che NDIS deve liberare. Questo indice è stato allocato in una chiamata precedente a NdisIfAllocateNetLuidIndex.

Valore restituito

NdisIfFreeNetLuidIndex restituisce uno dei valori seguenti:

Codice restituito Descrizione
NDIS_STATUS_SUCCESS
 Operazione riuscita.
DIS_STATUS_INVALID_PARAMETER
 NdisIfFreeNetLuidIndex non è riuscito perché il parametro NetLuidIndex ha specificato un indice non allocato per il tipo specificato dal parametro IfType .
 

Se la chiamata a NdisIfFreeNetLuidIndex ha esito negativo, il provider di interfaccia deve rimuovere tutte le informazioni salvate nell'archiviazione permanente correlata all'indice. La rimozione delle informazioni garantisce che il provider non tenti di liberare un indice già liberato dopo il riavvio del computer.

Commenti

I provider di interfacce NDIS chiamano la funzione NdisIfFreeNetLuidIndex per liberare un indice NET_LUID . Il provider di interfaccia deve liberare l'indice NET_LUID solo se l'interfaccia non verrà più utilizzata nel computer locale.

NdisIfFreeNetLuidIndex restituisce un indice NET_LUID precedentemente allocato a NDIS per la possibile riallocazione in un'altra interfaccia. Il chiamante deve passare lo stesso tipo di interfaccia in IfType usato quando ha chiamato il Funzione NdisIfAllocateNetLuidIndex per allocare l'indice NET_LUID.

Il provider non deve usare l'indice NET_LUID liberato o il valore NET_LUID associato in qualsiasi altra chiamata di funzione NDIS dopo aver chiamato NdisIfFreeNetLuidIndex.

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)

Vedi anche

NET_LUID

NdisIfAllocateNetLuidIndex