Função NdisIfFreeNetLuidIndex (ndis.h)

Artigo
02/07/2025

A função NdisIfFreeNetLuidIndex libera um índice de NET_LUID de interface de rede que foi alocado anteriormente por uma chamada para o função de NdisIfAllocateNetLuidIndex.

Sintaxe

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

Parâmetros

ifType

O tipo de interface para o qual o índice foi alocado. O chamador deve fornecer o mesmo valor usado quando alocou o índice NET_LUID com NdisIfAllocateNetLuidIndex. Para obter uma lista de tipos de interface, consulte tipos de interface NDIS.

[in] NetLuidIndex

O valor de índice NET_LUID que o NDIS deve liberar. Esse índice foi alocado em uma chamada anterior para NdisIfAllocateNetLuidIndex.

Valor de retorno

NdisIfFreeNetLuidIndex retorna um dos seguintes valores:

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	A operação foi concluída com êxito.
DIS_STATUS_INVALID_PARAMETER	NdisIfFreeNetLuidIndex falhou porque o parâmetro NetLuidIndex especificou um índice que não foi alocado para o tipo que o parâmetro IfType especificado.

Se a chamada para NdisIfFreeNetLuidIndex falhar, o provedor de interface deverá remover todas as informações salvas no armazenamento persistente relacionadas ao índice. A remoção das informações garantirá que o provedor não continue tentando liberar um índice que já esteja liberado após a reinicialização do computador.

Observações

Os provedores de interface NDIS chamam a função NdisIfFreeNetLuidIndex para liberar um índice de NET_LUID. O provedor de interface deve liberar o índice NET_LUID somente se a interface não for mais usada no computador local.

NdisIfFreeNetLuidIndex retorna um índice de NET_LUID alocado anteriormente para NDIS para possível realocação para outra interface. O chamador deve passar o mesmo tipo de interface em IfType que ele usou quando chamou o função NdisIfAllocateNetLuidIndex para alocar o índice NET_LUID.

O provedor não deve usar o índice de NET_LUID liberado ou o valor de NET_LUID associado em qualquer outra chamada de função NDIS depois de chamar NdisIfFreeNetLuidIndex.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no NDIS 6.0 e posterior.
da Plataforma de Destino	Área de trabalho
cabeçalho	ndis.h (inclua Ndis.h)
biblioteca	Ndis.lib
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	Irql_Interfaces_Function(ndis)

Consulte também

NET_LUID

NdisIfAllocateNetLuidIndex

Compartilhar via