Funzione NdisIfFreeNetLuidIndex (ndis.h)
La funzione NdisIfFreeNetLuidIndex libera un'interfaccia di rete NET_LUID indice allocato in precedenza da una chiamata a funzione di 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 |
|---|---|
|
Operazione completata correttamente. |
|
NdisIfFreeNetLuidIndex non riuscito perché il parametro NetLuidIndex 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 correlate all'indice. La rimozione delle informazioni garantisce che il provider non tenti di liberare un indice già liberato dopo il riavvio del computer.
Osservazioni
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ù usata nel computer locale.
NdisIfFreeNetLuidIndex restituisce un indice NET_LUID allocato in precedenza 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 di 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.