Compartir a través de


Función NdisQueryAdapterInstanceName (ndis.h)

La función NdisQueryAdapterInstanceName recupera el nombre descriptivo de una NIC física o un adaptador virtual al que está enlazado el controlador de protocolo de llamada.

Sintaxis

NDIS_STATUS NdisQueryAdapterInstanceName(
       PNDIS_STRING pAdapterInstanceName,
  [in] NDIS_HANDLE  NdisBindingHandle
);

Parámetros

pAdapterInstanceName

Puntero a un tipo de NDIS_STRING proporcionado por el autor de la llamada que recibe una cadena Unicode contada. Esta cadena especifica el nombre descriptivo de la interfaz a la que hace referencia el enlace. Esta interfaz es una NIC física o un adaptador virtual. Para Windows 2000 y versiones posteriores, NDIS define el tipo de NDIS_STRING como un tipo de UNICODE_STRING .

[in] NdisBindingHandle

Identificador que identifica el enlace a la NIC física de destino o al adaptador virtual del controlador siguiente inferior al que está enlazado el autor de la llamada. Normalmente, la función NdisBindingHandle devolvió NdisOpenAdapterEx .

Valor devuelto

NdisQueryAdapterInstanceName devuelve NDIS_STATUS_SUCCESS si la memoria de la cadena en AdapterInstanceName se asignó correctamente; de lo contrario, devuelve NDIS_STATUS_RESOURCES.

Comentarios

Un controlador de protocolo usa NdisQueryAdapterInstanceName para recuperar el nombre descriptivo de una NIC física o un adaptador virtual al que está enlazado el controlador de protocolo. El controlador de protocolo especifica el identificador para este tipo de adaptador virtual o NIC en NdisBindingHandle . El controlador de protocolo llama a la función NdisOpenAdapterEx para recuperar este identificador.

NdisQueryAdapterInstanceName asigna memoria para la cadena que especifica el nombre descriptivo. Una vez que el autor de la llamada termine de usar esta memoria, el llamador debe llamar a la función NdisFreeMemory para liberar la memoria.

Los nombres descriptivos están diseñados para ayudar al usuario a identificar de forma rápida e precisa una NIC física o un adaptador virtual, por ejemplo, "Adaptador Ethernet PCI" y "Adaptador de red privada virtual" se consideran nombres descriptivos.

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte NdisQueryAdapterInstanceName (NDIS 5.1)) en Windows Vista. Compatible con controladores NDIS 5.1 (consulte NdisQueryAdapterInstanceName (NDIS 5.1)) en Windows XP.
Plataforma de destino Escritorio
Encabezado ndis.h (incluya Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
Reglas de cumplimiento de DDI Irql_Miscellaneous_Function(ndis)

Consulte también

NdisFreeMemory

NdisOpenAdapterEx

UNICODE_STRING