Função NdisQueryAdapterInstanceName (ndis.h)
A função NdisQueryAdapterInstanceName recupera o nome amigável de uma NIC física ou de um adaptador virtual ao qual o driver de protocolo de chamada está associado.
Sintaxe
NDIS_STATUS NdisQueryAdapterInstanceName(
PNDIS_STRING pAdapterInstanceName,
[in] NDIS_HANDLE NdisBindingHandle
);
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 à qual a associação se refere. Essa interface é uma NIC física ou um adaptador virtual. Para o Windows 2000 e posterior, o NDIS define o tipo de NDIS_STRING como um tipo de UNICODE_STRING.
[in] NdisBindingHandle
Um identificador que identifica a associação à NIC física de destino ou ao adaptador virtual do driver inferior ao qual o chamador está associado. Normalmente, NdisBindingHandle foi retornado pela função NdisOpenAdapterEx.
Valor de retorno
NdisQueryAdapterInstanceName 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 protocolo usa NdisQueryAdapterInstanceName para recuperar o nome amigável de uma NIC física ou de um adaptador virtual ao qual o driver de protocolo está associado. O driver de protocolo especifica o identificador para tal NIC ou adaptador virtual em NdisBindingHandle . O driver de protocolo chama a função NdisOpenAdapterEx para recuperar esse identificador.
NdisQueryAdapterInstanceName 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.