Função NdisQueryAdapterInstanceName (ndis.h)

A função NdisQueryAdapterInstanceName recupera o nome amigável de uma NIC física ou 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 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 era retornado pela função NdisOpenAdapterEx .

Retornar valor

NdisQueryAdapterInstanceName retornará NDIS_STATUS_SUCCESS se a memória da cadeia de caracteres em AdapterInstanceName tiver sido alocada com êxito; caso contrário, retornará NDIS_STATUS_RESOURCES.

Comentários

Um driver de protocolo usa NdisQueryAdapterInstanceName para recuperar o nome amigável de uma NIC física ou um adaptador virtual ao qual o driver de protocolo está associado. O driver de protocolo especifica o identificador para tal NIC ou adaptador virtual no 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.

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.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisQueryAdapterInstanceName (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisQueryAdapterInstanceName (NDIS 5.1)) no Windows XP.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regras de conformidade de DDI	Irql_Miscellaneous_Function(ndis)

Confira também

NdisFreeMemory

NdisOpenAdapterEx

UNICODE_STRING