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) |