Função NdisMQueryAdapterInstanceName (ndis.h)

A função NdisMQueryAdapterInstanceName recupera o nome amigável de um adaptador de miniport.

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 NDIS_STRING como um tipo de UNICODE_STRING .

MiniportHandle

O identificador para o adaptador de miniporte que foi inserido anteriormente no Função MiniportInitializeEx .

Retornar valor

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

Comentários

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 miniport. O driver de miniporto especifica o identificador para um adaptador de miniport no MiniportAdapterHandle . Esse identificador para o adaptador de miniporto é passado para a função MiniportInitializeEx do driver de miniport 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.

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 no NDIS 5.1 e no NDIS 6.0 e posterior. Para drivers NDIS 5.1, consulte NdisMQueryAdapterInstanceName (NDIS 5.1).
Plataforma de Destino	Universal
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	PASSIVE_LEVEL
Regras de conformidade de DDI	Irql_Miniport_Driver_Function(ndis)

Confira também

MiniportInitializeEx

NdisFreeMemory

UNICODE_STRING