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 solicitudes de establecimiento.
Los controladores de miniport 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 de 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 acción de en WWAN_GET_VISIBLE_PROVIDERS está establecido en WWAN_GET_VISIBLE_PROVIDERS_ALL el miniport debe devolver todos los proveedores visibles. Cuando el miembro action de de WWAN_GET_VISIBLE_PROVIDERS está establecido en WWAN_GET_VISIBLE_PROVIDERS_MULTICARRIER el miniport solo debe devolver proveedores multiporte 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 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 rssi de y ErrorRate miembros de WWAN_PROVIDER2 estructura deben establecerse si están disponibles.
Observaciones
Para obtener más información sobre el uso de este OID, consulte wwAN Provider Operations.
Los controladores de miniport pueden acceder al módulo de identidad de suscriptor (tarjeta SIM) al procesar las operaciones de consulta, pero no deben acceder a la red del proveedor.
Los controladores de miniport deben establecer el miembro VisibleListHeader.ElementType en WwanStructProvider.
En el caso de las redes basadas en CDMA, el controlador de miniporte debe devolver solo 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 de WWAN_STATUS_BUSY en el miembro uStatus de la estructura NDIS_WWAN_VISIBLE_PROVIDERS.
Tanto los dispositivos basados en GSM como los basados en CDMA deben admitir el examen de proveedores visibles mientras están en modo registrado. Sin embargo, no es necesario que los controladores de miniporte admitan 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 (include Ndis.h) |