OID_WWAN_VISIBLE_PROVIDERS
OID_WWAN_VISIBLE_PROVIDERS devuelve una lista de proveedores de red visibles actualmente dentro del intervalo del dispositivo MB.
No se admiten las solicitudes establecidas.
Los controladores de minipuerto deben procesar las solicitudes de consulta de forma asincrónica, devolviendo inicialmente NDIS_STATUS_INDICATION_REQUIRED a la solicitud original y, posteriormente, enviando una notificación de estado NDIS_STATUS_WWAN_VISIBLE_PROVIDERS que contiene una estructura de NDIS_WWAN_VISIBLE_PROVIDERS para proporcionar información sobre los proveedores de red visibles al completar las solicitudes de consulta.
Las solicitudes de consulta especifican NDIS_WWAN_GET_VISIBLE_PROVIDERS estructura como entrada. Cuando el miembro Action de WWAN_GET_VISIBLE_PROVIDERS se establece en WWAN_GET_VISIBLE_PROVIDERS_ALL el miniport debe devolver todos los proveedores visibles. Cuando el miembro Action de WWAN_GET_VISIBLE_PROVIDERS se establece en WWAN_GET_VISIBLE_PROVIDERS_MULTICARRIER el miniporte solo debe devolver proveedores de múltiples operadores visibles que se pueden establecer como proveedor principal.
La lista de proveedores visibles devuelta por el dispositivo debe tener el estado del proveedor establecido correctamente para cada uno de los proveedores. Por ejemplo, los proveedores preferidos de multicarrier deben etiquetarse como WWAN_PROVIDER_STATE_PREFERRED_MULTICARRIER, el proveedor principal actual si alguno debe etiquetarse como WWAN_PROVIDER_STATE_HOME, el proveedor registrado actual si alguno debe etiquetarse como WWAN_PROVIDER_STATE_REGISTERED.
Los miembros Rssi y ErrorRate de WWAN_PROVIDER2 estructura deben establecerse si están disponibles.
Observaciones
Para obtener más información sobre el uso de este OID, consulte Operaciones del proveedor WWAN.
Los controladores de minipuerto pueden acceder al módulo de identidad del suscriptor (tarjeta SIM) al procesar las operaciones de consulta, pero no deben acceder a la red del proveedor.
Los controladores miniport deben establecer el miembro VisibleListHeader.ElementType en WwanStructProvider.
En el caso de las redes basadas en FRAMEWORK, el controlador de minipuerto solo debe devolver el proveedor principal, si alguna de las redes de la lista de itinerancia preferida (PRL) está visible actualmente. En el caso de las redes basadas en GSM, puede haber más de un proveedor en la lista de proveedores visibles.
Los dispositivos que no admiten el examen de proveedores visibles mientras están conectados deben devolver el valor de error WWAN_STATUS_BUSY en el miembro uStatus de la estructura NDIS_WWAN_VISIBLE_PROVIDERS.
Tanto los dispositivos basados en GSM como los basados en FRAMEWORK deben admitir el examen de proveedores visibles mientras están en modo registrado. Sin embargo, los controladores de minipuerto no son necesarios para admitir el examen del proveedor visible mientras un contexto del Protocolo de datos de paquetes (PDP) está activo (por ejemplo, el dispositivo está conectado a la red del proveedor).
Requisitos
Versión |
Disponible en Windows 7 y versiones posteriores de Windows. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |