Partilhar via


Função NdisIfFreeNetLuidIndex (ndis.h)

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