Función NdisMQueryAdapterInstanceName (ndis.h)
La función NdisMQueryAdapterInstanceName recupera el nombre descriptivo de un adaptador de miniport.
Sintaxis
NDIS_STATUS NdisMQueryAdapterInstanceName(
PNDIS_STRING pAdapterInstanceName,
NDIS_HANDLE MiniportHandle
);
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 para el adaptador de minipuerto especificado. Para Windows Vista y versiones posteriores del sistema operativo Windows, NDIS define el tipo de NDIS_STRING como un tipo de UNICODE_STRING .
MiniportHandle
Identificador del adaptador de minipuerto que se ha introducido anteriormente en el Función MiniportInitializeEx .
Valor devuelto
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 miniport usa NdisMQueryAdapterInstanceName para recuperar el nombre descriptivo de una interfaz que controla el controlador de minipuerto. Esta interfaz es una NIC física o un adaptador virtual y se denomina adaptador de minipuerto. El controlador miniport especifica el identificador de un adaptador de miniport en MiniportAdapterHandle . Este identificador al adaptador de minipuerto se pasa a la función MiniportInitializeEx del controlador de miniport para configurar el adaptador de minipuerto para las operaciones de E/S de red.
NdisMQueryAdapterInstanceName 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 NDIS 5.1 y NDIS 6.0 y versiones posteriores. Para los controladores NDIS 5.1, consulte NdisMQueryAdapterInstanceName (NDIS 5.1). |
| Plataforma de destino | Universal |
| Encabezado | ndis.h (incluya Ndis.h) |
| Library | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | Irql_Miniport_Driver_Function(ndis) |