Função NdisMQueryAdapterInstanceName (ndis.h)
A função NdisMQueryAdapterInstanceName recupera o nome amigável de um adaptador de miniporto.
Sintaxe
NDIS_STATUS NdisMQueryAdapterInstanceName(
PNDIS_STRING pAdapterInstanceName,
NDIS_HANDLE MiniportHandle
);
Parâmetros
pAdapterInstanceName
Um ponteiro para um tipo de NDIS_STRING fornecido pelo chamador que recebe uma cadeia de caracteres Unicode contada. Essa cadeia de caracteres especifica o nome amigável da interface para o adaptador de miniporto fornecido. Para o Windows Vista e versões posteriores do sistema operacional Windows, o NDIS define o tipo de NDIS_STRING como um tipo de UNICODE_STRING.
MiniportHandle
O identificador para o adaptador de miniporto que anteriormente era inserido no função MiniportInitializeEx.
Valor de retorno
Retorna NDIS_STATUS_SUCCESS se a memória da cadeia de caracteres em AdapterInstanceName foi alocada com êxito; caso contrário, ele retorna NDIS_STATUS_RESOURCES.
Observações
Um driver de miniporto usa NdisMQueryAdapterInstanceName para recuperar o nome amigável de uma interface que o driver de miniporto controla. Essa interface é uma NIC física ou um adaptador virtual e é chamada de adaptador de miniporto. O driver de miniporto especifica o identificador para um adaptador de miniporto no MiniportAdapterHandle . Esse identificador para o adaptador de miniporto é passado para a função MiniportInitializeEx do driver de miniporto para configurar o adaptador de miniporto para operações de E/S de rede.
NdisMQueryAdapterInstanceName aloca memória para a cadeia de caracteres que especifica o nome amigável. Depois que o chamador terminar de usar essa memória, o chamador deverá chamar a função NdisFreeMemory para liberar a memória.
Os nomes amigáveis destinam-se a ajudar o usuário a identificar com rapidez e precisão uma NIC física ou um adaptador virtual, por exemplo, "Adaptador PCI Ethernet" e "Adaptador de Rede Virtual Privada" são considerados nomes amigáveis.