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