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