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 del 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 con recuento. 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 De 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.
Observaciones
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 con el 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 | Valor |
|---|---|
| cliente mínimo admitido | 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. |
| de la plataforma de destino de | Escritorio |
| encabezado de | ndis.h (incluya Ndis.h) |
| biblioteca de | Ndis.lib |
| irQL | <= DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | NdisQueryBindInstanceName(ndis) |