Función NdisQueryBindInstanceName (ndis.h)
La función NdisQueryBindInstanceName recupera el nombre descriptivo de una NIC física o un adaptador virtual al que se enlazará el controlador de protocolo de llamada.
Sintaxis
NDIS_STATUS NdisQueryBindInstanceName(
[out] PNDIS_STRING pAdapterInstanceName,
[in] NDIS_HANDLE BindingContext
);
Parámetros
[out] 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 los sistemas operativos Microsoft Windows 2000 y versiones posteriores, NDIS define el tipo de NDIS_STRING como un tipo de UNICODE_STRING .
[in] BindingContext
Identificador que identifica el área de contexto de NDIS para la operación de enlace. NDIS pasó este identificador al parámetro BindContext del Función ProtocolBindAdapterEx .
Valor devuelto
NdisQueryBindInstanceName devuelve NDIS_STATUS_SUCCESS si la memoria de la cadena en pAdapterInstanceName se asignó correctamente; de lo contrario, devuelve NDIS_STATUS_RESOURCES.
Comentarios
Un controlador de protocolo usa NdisQueryBindInstanceName para recuperar el nombre descriptivo de una NIC física o un adaptador virtual al que se enlazará el controlador de protocolo. El controlador de protocolo especifica el contexto de enlace que NDIS proporcionó en el Función ProtocolBindAdapterEx .
Los controladores de protocolo pueden usar NdisQueryBindInstanceName para obtener el nombre descriptivo antes de enlazar al adaptador.
NdisQueryBindInstanceName asigna memoria para la cadena que especifica el nombre descriptivo. Una vez que el autor de la llamada termine de usar esta memoria, el autor de la llamada 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 y 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 los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisQueryBindInstanceName (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisQueryBindInstanceName (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 | NdisQueryBindInstanceName(ndis) |