estructura WWAN_REGISTRATION_STATE (wwan.h)
La estructura WWAN_REGISTRATION_STATE representa el estado de registro del dispositivo MB.
Sintaxis
typedef struct _WWAN_REGISTRATION_STATE {
ULONG uNwError;
WWAN_REGISTER_STATE RegisterState;
WWAN_REGISTER_MODE RegisterMode;
WCHAR ProviderId[WWAN_PROVIDERID_LEN];
WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
WCHAR RoamingText[WWAN_ROAMTEXT_LEN];
DWORD WwanRegFlags;
WWAN_CELLULAR_CLASS CurrentCellularClass;
ULONG PreferredDataClasses;
} WWAN_REGISTRATION_STATE, *PWWAN_REGISTRATION_STATE;
Miembros
uNwError
Un error específico de red, en caso de error de registro. Para obtener más información sobre este miembro, vea la siguiente sección "Comentarios".
RegisterState
Estado de registro del dispositivo. Para obtener una lista de valores definidos, vea WWAN_REGISTER_STATE.
El valor WwanRegisterStatePartner indica que el dispositivo está en itinerancia en un proveedor de red de asociados preferidos, mientras que wwanRegisterStateRoaming valor indica que el dispositivo es simplemente móvil. Si la caracterización del asociado del estado de itinerancia no está disponible, el controlador de miniporte debe informar WwanRegisterStateRoaming.
RegisterMode
Modo de registro del dispositivo. Para obtener una lista de valores definidos, consulte WWAN_REGISTER_MODE.
ProviderId[WWAN_PROVIDERID_LEN]
Cadena numérica terminada en NULL (0-9) que representa la identidad del proveedor de red.
Para las redes basadas en GSM, esta cadena es una concatenación de un código de país móvil de tres dígitos (MCC) y un código de red móvil de dos o tres dígitos (MNC). Los operadores basados en GSM pueden tener más de un MNC y, por tanto, más de un proveedor de providerId .
Para las redes basadas en CDMA, esta cadena es un identificador del sistema de cinco dígitos (SID). Por lo general, un operador basado en CDMA tiene más de un SID. Normalmente, un operador tiene un SID para cada mercado, que normalmente se divide geográficamente dentro de una nación por normativas, como Áreas Estadísticas Metropolitanas (MSA) en los Estados Unidos de América. Los controladores de miniporte de dispositivos basados en CDMA deben especificar WWAN_CDMA_DEFAULT_PROVIDER_ID si esta información no está disponible.
Al procesar una consulta de solicitud y el estado de registro está en modo de registro automático, este miembro contiene el identificador de proveedor al que está asociado el dispositivo (si procede). Cuando el estado de registro está en modo de registro manual, este miembro contiene el identificador de proveedor con el que se solicita que el dispositivo se registre (incluso si el proveedor no está disponible).
Al procesar un establecer solicitud y el estado de registro está en modo manual, contiene el identificador de proveedor seleccionado por el servicio MB para que el dispositivo se registre. Cuando el estado de registro está en modo de registro automático, se omite este parámetro.
Los proveedores CDMA 1xRTT deben establecerse en WWAN_CDMA_DEFAULT_PROVIDER_ID si el identificador del proveedor no está disponible.
ProviderName[WWAN_PROVIDERNAME_LEN]
Cadena terminada en NULL que representa el nombre del proveedor de red. Este miembro está limitado a, como máximo, WWAN_PROVIDERNAME_LEN caracteres.
Para las redes basadas en GSM, si la presentación preferida de iniciales de país y nombre de red móvil (PPCI&N) tiene más de veinte caracteres, el controlador de miniport debe abreviar el nombre de red.
Este miembro se omite cuando el servicio MB establece la lista de proveedores preferidos.
Los controladores de miniport deben especificar un cadena NULL para los dispositivos que no tienen esta información.
RoamingText[WWAN_ROAMTEXT_LEN]
Cadena terminada en NULL para informar al usuario de que el dispositivo está en itinerancia. Este miembro está limitado a como máximo WWAN_ROAMTEXT_LEN caracteres.
Este texto debe proporcionar información adicional al usuario cuando el estado de registro sea WwanRegisterStatePartner o WwanRegisterStateRoaming. Este miembro es opcional.
WwanRegFlags
Marcas de registro.
| Valor | Significado |
|---|---|
| WWAN_REG_FLAGS_NONE | No hay marcas de registro. |
| WWAN_REG_FLAGS_NO_MANUAL_REG | No hay conexión manual. |
| WWAN_REG_FLAGS_PS_AUTO_ATTACH | Indica que el dispositivo MB administra su propio contexto de paquete. El servicio MB no enviará un paquete desasociación al controlador de miniport, pero puede enviar una conexión de paquetes. |
CurrentCellularClass
La clase de telefonía móvil actual de la red registrada. Para las redes que solo admiten una sola clase de telefonía móvil, este miembro debe establecerse en esa clase de telefonía móvil. En el caso de las redes compatibles con varios modos, el controlador de miniporte envía notificaciones NDIS_STATUS_WWAN_REGISTER_STATE al servicio MB cuando la red cambia su clase de telefonía móvil.
PreferredDataClasses
Máscara de bits que representa las tecnologías de acceso a datos que se prefieren para una conexión.
Observaciones
consulta y establecer solicitudes de OID, así como eventos de estado no solicitados, usan el miembro uNwError de. Si no hay ningún error específico de red o no se conoce el error específico de la red, los controladores de miniport deben establecer este miembro en cero. La sección "Estructura de indicación de estado" de semántica operativa de MB muestra los valores de error de código de causa de registro definidos en el 3GPP TS 24.008 Specification.
Los puntos siguientes proporcionan instrucciones para devolver un error específico de red en distintos escenarios:
- Si se produce un error en el registro de red debido a un error específico de la red, los controladores de miniportar deben devolver el error específico de la red en respuesta a consulta solicitudes. En este caso, los controladores de miniport deben establecer el miembro uStatus de la estructura de NDIS_WWAN_REGISTRATION_STATE en WWAN_STATUS_SUCCESS y establecer el miembro uNwError en el código de error específico de la red.
- Si se produce un error en un establecer solicitud, los controladores de miniporte deben devolver el código de error específico de la red. En este caso, los controladores de miniport deben establecer el miembro uStatus de la estructura de NDIS_WWAN_REGISTRATION_STATE en WWAN_STATUS_FAILURE y establecer el miembro uNwError en el código de error específico de la red.
- Cada vez que el estado de registro del dispositivo cambia porque la red desconscribe el dispositivo (por ejemplo, la red desinscribió el dispositivo porque la suscripción del dispositivo expiró) los eventos de estado no solicitados deben incluir el error específico de la red. En este caso, el controlador de miniport debe establecer el miembro uStatus de la estructura de NDIS_WWAN_REGISTRATION_STATE en WWAN_STATUS_SUCCESS y establecer el miembro uNwError en el código de error específico de la red.
Los controladores de miniport pueden proporcionar códigos de error adicionales según lo definido por la especificación de estándares GSM de códigos de error de conexión de paquetes devueltos por la red. Por ejemplo, los controladores de miniport pueden comunicar los códigos de error de asociación de paquetes 3GPP TS 24.008, como el código de error 12 (no se permite el área de ubicación), al servicio MB a través del miembro uNwError.
Los controladores de miniport deben notificar el código de causa a la primera instancia posible. Por ejemplo, si el dispositivo MB encuentra uno de estos códigos al intentar registrar el dispositivo en con un proveedor de red, el controlador de miniporte debe notificarlo en ese momento.
Los controladores de miniportar conectados a una red en modo múltiple deben indicar que la clase de telefonía móvil cambia a través de una notificación de NDIS_STATUS_WWAN_REGISTER_STATE.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 8 y versiones posteriores de Windows. |
| encabezado de | wwan.h (incluya Wwan.h) |