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