Função NdisIfFreeNetLuidIndex (ndis.h)

A função NdisIfFreeNetLuidIndex libera um adaptador de rede NET_LUID índice que foi alocado anteriormente por uma chamada para o Função 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 NET_LUID valor de índice que o NDIS deve liberar. Esse índice foi alocado em uma chamada anterior para NdisIfAllocateNetLuidIndex.

Retornar valor

NdisIfFreeNetLuidIndex retorna um dos seguintes valores:

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

 

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.

Comentários

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 NET_LUID associado em nenhuma outra função NDIS chama NdisIfFreeNetLuidIndex.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no NDIS 6.0 e posterior.
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)

Confira também

NET_LUID

NdisIfAllocateNetLuidIndex