Compartilhar via


Função NdisQueryBindInstanceName (ndis.h)

A função NdisQueryBindInstanceName recupera o nome amigável de uma NIC física ou um adaptador virtual ao qual o driver de protocolo de chamada será associado.

Sintaxe

NDIS_STATUS NdisQueryBindInstanceName(
  [out] PNDIS_STRING pAdapterInstanceName,
  [in]  NDIS_HANDLE  BindingContext
);

Parâmetros

[out] 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 Microsoft Windows 2000 e sistemas operacionais posteriores, o NDIS define o tipo NDIS_STRING como um tipo de UNICODE_STRING .

[in] BindingContext

Um identificador que identifica a área de contexto do NDIS para a operação de associação. O NDIS passou esse identificador para o parâmetro BindContext do Função ProtocolBindAdapterEx .

Retornar valor

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

Comentários

Um driver de protocolo usa NdisQueryBindInstanceName para recuperar o nome amigável de uma NIC física ou um adaptador virtual ao qual o driver de protocolo será associado. O driver de protocolo especifica o contexto de associação fornecido pelo NDIS no Função ProtocolBindAdapterEx .

Os drivers de protocolo podem usar NdisQueryBindInstanceName para obter o nome amigável antes de se associarem ao adaptador.

NdisQueryBindInstanceName 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 NdisQueryBindInstanceName (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisQueryBindInstanceName (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 NdisQueryBindInstanceName(ndis)

Confira também

NdisFreeMemory

ProtocolBindAdapterEx

UNICODE_STRING