estructura de WWAN_CONTEXT_STATE (wwan.h)
La estructura de WWAN_CONTEXT_STATE representa el estado de contexto del Protocolo de datos de paquetes (PDP) del dispositivo MB.
Sintaxis
typedef struct _WWAN_CONTEXT_STATE {
ULONG uNwError;
ULONG ConnectionId;
WWAN_ACTIVATION_STATE ActivationState;
WWAN_VOICE_CALL_STATE VoiceCallState;
WWAN_IP_TYPE IPType;
WWAN_CONNECTION_MEDIA ConnectionMedia;
WCHAR AccessString[WWAN_ACCESSSTRING_LEN];
WWAN_SINGLE_NSSAI Snssai;
ULONG FoundMatchingConnectionId;
WWAN_OFFSET_SIZE_ELEMENT TrafficParameters;
} WWAN_CONTEXT_STATE, *PWWAN_CONTEXT_STATE;
Miembros
uNwError
Un error específico de la red. En la tabla siguiente se muestran los valores de error de conexión como se documenta en la especificación TS 24.008 de 3GPP.
| Código de causa de 3GPP 24.008 | Interpretación del código de causa |
|---|---|
| 8 - Operador determinado barring | El operador bloquea el servicio de datos de paquetes. |
| 26 - Recursos insuficientes | El contexto no se puede activar debido a recursos insuficientes en la red. |
| 27 - Nombre de punto de acceso desconocido o ausente (APN) | No se proporciona NINGÚN APN ni APN desconocido en la solicitud de activación. |
| 29 , 30, 31: error de autenticación de usuario | Nombre de usuario o contraseña incorrectos proporcionados en la solicitud de activación. |
| 32 - No se admite la opción de servicio | GPRS no es compatible con la red. |
| 33 - La opción de servicio solicitada no está suscrita | El usuario no suscribe el servicio solicitado (GPRS). |
| 34 - La opción de servicio está temporalmente fuera del orden | El servicio de datos de paquetes no está ordenado temporalmente. El usuario debe volver a intentarlo más adelante. |
| 43: contexto de protocolo de datos de paquetes desconocido (PDP) | No se proporciona NINGÚN APN ni APN desconocido en la solicitud de activación. |
ConnectionId
El servicio MB especifica un valor para este miembro en el momento de la solicitud de conexión mediante OID_WWAN_CONNECT. Los controladores de miniport deben copiar este valor y usarlos cuando notifiquen al servicio MB en los cambios de estado de conexión posteriores.
ActivationState
Estado de activación actual del dispositivo.
VoiceCallState
Estado actual de la llamada de voz del dispositivo.
IPType
Valor de la enumeración WWAN_IP_TYPE que especifica el tipo de IP.
ConnectionMedia
Tipo de medio para un contexto o sesión establecido.
AccessString[WWAN_ACCESSSTRING_LEN]
ApN/DNN seleccionado para un contexto o sesión establecido.
Snssai
Estructura de WWAN_SINGLE_NSSAI que representa una única información de asistencia de selección de segmentos de red (NSSAI).
FoundMatchingConnectionId
Solo es válido si el estado es WWAN_STATUS_SESSION_ALREADY_EXISTS.
TrafficParameters
Estructura de WWAN_OFFSET_SIZE_ELEMENT . Solo es válido si el estado es WWAN_STATUS_DESSOCIATION_NEEDED_FOR_APPLICATION. Los primeros 4 bytes son el desplazamiento a DataBuffer que contiene los datos sin procesar de MBIM_TLV_TYPE_TRAFFIC_PARAMETERS, en bytes, calculados desde el principio de WWAN_SET_CONTEXT_STATE. Los segundos 4 bytes son el tamaño de los datos sin procesar de MBIM_TLV_TYPE_TRAFFIC_PARAMETERS, en bytes.
Comentarios
Establecer Las solicitudes OID, así como los eventos de estado no solicitados, usan el miembro uNwError . 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 0.
Los puntos siguientes proporcionan instrucciones para devolver un error específico de red en diferentes escenarios:
- Si se produce un error en una solicitud establecida, los controladores de minipuerto deben devolver el código de error específico de la red. En este caso, el controlador de miniport debe establecer el miembro uStatus de la estructura de NDIS_WWAN_CONTEXT_STATE en WWAN_STATUS_FAILURE, o un error más específico, como WWAN_STAUS_INVALID_ACCESS_STRING o WWAN_STATUS_INVALID_USER_NAME_PWD, y establecer el miembro uNwError en el código de error específico de la red.
- Cada vez que cambia el estado de activación del contexto del dispositivo debido a la desactivación del contexto iniciado por la red, 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_CONTEXT_STATE en WWAN_STATUS_SUCCESS y establecer el miembro uNwError en el código de error específico de la red.
En caso de respuesta a la NDIS_WWAN_SET_CONTEXT_STATE, use este miembro para proporcionar códigos de error adicionales devueltos por la red.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 8 y versiones posteriores de Windows. |
| Encabezado | wwan.h (incluya Wwan.h) |