Usando um índice de NET_LUID

O NDIS fornece funções para alocar e liberar NET_LUID índices necessários para criar valores NET_LUID. Um provedor de interface NDIS deve alocar um valor NET_LUID para registrar uma interface.

Para alocar um índice NET_LUID, um provedor de interface chama a função NdisIfAllocateNetLuidIndex . Depois de alocar o índice, o provedor de interface chama a macro NDIS_MAKE_NET_LUID para criar o valor NET_LUID. Para liberar um índice NET_LUID, um provedor de interface chama a função NdisIfFreeNetLuidIndex .

NdisIfAllocateNetLuidIndex tenta alocar um valor de 24 bits associado ao tipo de interface que o chamador especificou no parâmetro IfType e que é exclusivo para o computador local. Se a alocação de índice for bem-sucedida, NdisIfAllocateNetLuidIndex retornará NDIS_STATUS_SUCCESS e fornecerá um índice NET_LUID no endereço fornecido no parâmetro pNetLuidIndex . Se o NDIS não conseguir encontrar um índice de NET_LUID livre, NdisIfAllocateNetLuidIndex retornará NDIS_STATUS_RESOURCES. NdisIfAllocateNetLuidIndex pode retornar outros valores de status NDIS para indicar erros internos no NDIS. O NDIS registra a alocação desse índice para quando o computador for reiniciado posteriormente. O NDIS não usará um índice específico para chamadores futuros, mesmo após a reinicialização do computador, até que o provedor de interface que alocou esse índice chame a função NdisIfFreeNetLuidIndex para esse índice.

NdisIfFreeNetLuidIndex libera um índice de NET_LUID alocado anteriormente para que o NDIS possa realocar esse índice para outra interface. O chamador precisa passar o tipo de interface idêntico em IfType que o chamador usou quando chamou NdisIfAllocateNetLuidIndex para alocar o índice NET_LUID. Se a operação de libertação for bem-sucedida, NdisIfFreeNetLuidIndex retornará NDIS_STATUS_SUCCESS. Se a chamada para NdisIfFreeNetLuidIndex falhar, o provedor de interface deverá remover todas as informações salvas no armazenamento persistente relacionadas ao índice NET_LUID. A remoção das informações garantirá que o provedor não continue tentando liberar um índice que já está liberado após cada reinicialização do computador. Depois de chamar NdisIfFreeNetLuidIndex, o chamador não deve usar o valor NET_LUID novamente, a menos que chame NdisIfAllocateNetLuidIndex novamente para o mesmo tipo de interface e receba o mesmo índice de NET_LUID que liberou.

Para registrar uma interface de rede, um provedor de interface deve passar um valor de NET_LUID válido para a função NdisIfRegisterInterface . Para obter mais informações sobre como registrar interfaces de rede, consulte Registrando uma interface de rede.