estructura WWAN_PACKET_SERVICE (wwan.h)
La estructura WWAN_PACKET_SERVICE representa el estado de datos adjuntos del servicio de paquetes del dispositivo MB.
Sintaxis
typedef struct _WWAN_PACKET_SERVICE {
ULONG uNwError;
WWAN_PACKET_SERVICE_STATE PacketServiceState;
ULONG AvailableDataClass;
ULONG CurrentDataClass;
WWAN_5G_FREQUENCY_RANGE FrequencyRange;
ULONG CurrentDataSubClass;
WWAN_SINGLE_TAI CurrentTai;
ULONG Rel3GppVer;
} WWAN_PACKET_SERVICE, *PWWAN_PACKET_SERVICE;
Miembros
uNwError
Un error específico de la red, en caso de un error de conexión de paquetes o desasociación de paquetes. Para obtener más información sobre este miembro, vea la siguiente sección "Comentarios".
PacketServiceState
Estado del servicio de paquetes del dispositivo.
AvailableDataClass
Mapa de bits que representa qué clases de datos están disponibles para el dispositivo en la red actual. Para obtener una lista detallada de valores, vea el miembro WwanDataClass de WWAN_DEVICE_CAPS.
Los controladores de minipuerto deben establecer este miembro en WWAN_DATA_CLASS_NONE cuando el dispositivo no está registrado en una red, o cuando no hay ninguna clase de datos o cuando la clase de datos admitida no está disponible. Los controladores de minipuerto deben establecer este miembro con un valor válido cuando el dispositivo está registrado en una red.
CurrentDataClass
Valor único del miembro WwanDataClass en WWAN_DEVICE_CAPS que representa qué clase de datos está usando actualmente el dispositivo.
Para todos los servicios de datos, excepto HSPA, los controladores de minipuerto deben establecer este miembro en un único valor de WWAN_DATA_CLASS_XXX. En el caso de los servicios de datos HSPA, los controladores de minipuerto deben especificar un OR bit a bit de WWAN_DATA_CLASS_HSDPA y WWAN_DATA_CLASS_HSUPA.
Los controladores de minipuerto deben establecer este miembro con un valor válido y enviar la notificación adecuada cuando el dispositivo cambie los servicios, por ejemplo, de 1xRTT a 1xEV-DO.
Los controladores de minipuerto deben establecer este miembro en WWAN_DATA_CLASS_CUSTOM si la clase de datos no es uno de los valores predefinidos en el miembro WwanDataClass de WWAN_DEVICE_CAPS.
FrequencyRange
Valor WWAN_5G_FREQUENCY_RANGE que especifica los intervalos de frecuencia que usa el dispositivo. Este miembro solo es válido si CurrentDataClass es WWAN_DATA_CLASS_5G_NSA o WWAN_DATA_CLASS_SA.
CurrentDataSubClass
Este campo solo se usa para NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.
CurrentTai
Estructura WWAN_SINGLE_TAI que representa la identidad del área de seguimiento (TAI) actual. Este campo solo se usa para NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.
Rel3GppVer
0xFFFFFFFF se usará si se desconoce. Desconocido significa que MBIM_TLV_TYPE_3GPP_REL_VERSION no está incluido en MBIM_PACKET_SERVICE_INFO_V3, el dispositivo devuelve directamente 0xFFFFFFFF o el dispositivo usa MBIM 3.0 o una versión anterior.
Comentarios
El estado actual del servicio de conexión de paquetes se refleja normalmente en la interfaz de usuario del dispositivo.
El servicio MB combina las clases de datos que se representan en AvailableDataClass con las clases de datos admitidas que se notifican con las funcionalidades del dispositivo para mostrar la intersección de las opciones disponibles para el usuario.
Si un dispositivo también admite una clase de datos que no sea los valores predefinidos en el miembro WwanDataClass de WWAN_DEVICE_CAPS, el controlador de minipuerto debe establecer la marca WWAN_DATA_CLASS_CUSTOM junto con la máscara de bits adecuada definida para la clase de datos de este miembro.
Consultar y establecer solicitudes de OID, así como 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 minipuerto deben establecer este miembro en cero. La sección "Estructura de indicación de estado" de mb semántica operativa muestra los valores de error de código de causa de conexión de paquetes o desasociación de paquetes definidos en la especificación TS 24.008 de 3GPP.
Los siguientes puntos proporcionan instrucciones para devolver un error específico de red en distintos escenarios:
- Si se produce un error en la operación de conexión de paquetes debido a un error específico de la red, los controladores de minipuerto deben devolver el error específico de la red en respuesta a las solicitudes de consulta . En este caso, los controladores de minipuerto deben establecer el miembro uStatus de la estructura NDIS_WWAN_PACKET_SERVICE_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 una solicitud set , los controladores de minipuerto deben devolver el código de error específico de la red. En este caso, los controladores de minipuerto deben establecer el miembro uStatus de la estructura NDIS_WWAN_PACKET_SERVICE_STATE en WWAN_STATUS_FAILURE y establecer el miembro uNwError en el código de error específico de la red.
- Siempre que el estado de registro del dispositivo cambie porque el paquete de red desasocia el dispositivo, los eventos de estado no solicitados deben incluir el error específico de la red. En este caso, el controlador de minipuerto debe establecer el miembro uStatus de la estructura NDIS_WWAN_PACKET_SERVICE_STATE en WWAN_STATUS_SUCCESS y establecer el miembro uNwError en el código de error específico de la red.
Los controladores de minipuerto deben notificar el código de causa en 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.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 7 y versiones posteriores de Windows. |
| Encabezado | wwan.h (incluye Wwan.h) |