estructura WWAN_SET_CONTEXT_STATE (wwan.h)
La estructura WWAN_SET_CONTEXT_STATE representa el comando para establecer el estado de contexto del protocolo de datos de paquetes (PDP) del dispositivo MB.
Sintaxis
typedef struct _WWAN_SET_CONTEXT_STATE {
ULONG ConnectionId;
WWAN_ACTIVATION_COMMAND ActivationCommand;
WCHAR AccessString[WWAN_ACCESSSTRING_LEN];
WCHAR UserName[WWAN_USERNAME_LEN];
WCHAR Password[WWAN_PASSWORD_LEN];
WWAN_COMPRESSION Compression;
WWAN_AUTH_PROTOCOL AuthType;
WWAN_IP_TYPE IPType;
WWAN_PSMEDIA_PREFERENCE MediaPreference;
WWAN_CONFIGURATION_SOURCE ConnectionMediaSource;
WWAN_ACTIVATION_OPTION ActivationOption;
WWAN_SINGLE_NSSAI Snssai;
WWAN_OFFSET_SIZE_ELEMENT TrafficParameters;
} WWAN_SET_CONTEXT_STATE, *PWWAN_SET_CONTEXT_STATE;
Miembros
ConnectionId
Mb Service especifica este miembro para identificar de forma única el contexto PDP y su estado correspondiente.
El servicio MB usa el valor de este miembro para identificar de forma única el contexto activo actual en los adaptadores de red mb.
El controlador de minipuerto debe usar el valor de este miembro al completar las solicitudes establecidas . El servicio MB usa el valor de este miembro en las solicitudes de consulta posteriores, así como las solicitudes de desconexión al controlador de miniport.
ActivationCommand
Active o desactive un contexto PDP al que se hace referencia en el miembro ConnectionId . En la tabla siguiente se muestran los valores posibles que puede especificar un controlador de minipuerto.
| Valor | Significado |
|---|---|
| WwanActivationCommandActivate | Active el contexto PDP al que hace referencia ConnectionId . |
| WwanActivationCommandDeactivate | Desactive un contexto PDP activado actualmente al que hace referencia ConnectionId . |
AccessString[WWAN_ACCESSSTRING_LEN]
Cadena terminada en NULL para acceder a la red. En el caso de las redes basadas en GSM, sería una cadena de nombre de punto de acceso (APN), como "data.thephone-company.com". En el caso de las redes basadas en SERVICE, podría tratarse de un código de marcado especial, como "#777" o un identificador de acceso a la red (NAI), como "foo@thephone-company.com". Este miembro puede ser NULL.
El tamaño de la cadena no debe superar los 100 bytes.
UserName[WWAN_USERNAME_LEN]
Cadena terminada en NULL que representa el nombre de usuario que se va a autenticar. Este miembro puede ser NULL.
Password[WWAN_PASSWORD_LEN]
Cadena terminada en NULL que representa la contraseña del nombre de usuario. Este miembro puede ser NULL.
Compression
Valor de la enumeración WWAN_COMPRESSION que especifica si se debe usar la compresión en la conexión de datos para el encabezado y los datos. Este miembro solo se aplica a los dispositivos basados en GSM. El servicio MB establece este miembro en WwanCompressionNone para dispositivos basados en STORAGE.
| Valor | Significado |
|---|---|
| WwanCompressionNone | No se aplica ninguna compresión. |
| WwanCompressionEnable | Habilite la compresión de encabezados y datos. |
AuthType
Valor de la enumeración WWAN_AUTH_PROTOCOL que especifica el tipo de autenticación que se va a usar para la activación de PDP. Este miembro solo se aplica a los dispositivos basados en GSM. El servicio MB establece este miembro en WwanAuthProtocolNone para dispositivos basados en SERVICE.
| Valor | Significado |
|---|---|
| WwanAuthProtocolNone | Sin protocolo de autenticación. |
| WwanAuthProtocolPap | Autenticación de contraseña sin cifrar. |
| WwanAuthProtocolChap | Use el Protocolo de autenticación de protocolo de enlace de desafío (CHAP). |
| WwanAuthProtocolMsChapV2 | Use microsoft Challenge Handshake Authentication Protocol (CHAP) v2.0. |
IPType
Valor de la enumeración WWAN_IP_TYPE que especifica el tipo de IP.
MediaPreference
ConnectionMediaSource
ActivationOption
Valor de la enumeración WWAN_ACTIVATION_OPTION que representa las opciones de activación del Protocolo de datos de paquetes (PDP) que admite el dispositivo MB.
Snssai
Estructura WWAN_SINGLE_NSSAI que representa una única información de asistencia de selección de segmentos de red (NSSAI).
TrafficParameters
Estructura WWAN_OFFSET_SIZE_ELEMENT . Los primeros 4 bytes son el desplazamiento al objeto DataBuffer que contiene los datos sin procesar del campo de datos de MBIM_TLV_TYPE_TRAFFIC_PARAMETERS, en bytes, calculado 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 campo de datos, en bytes.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 8 y versiones posteriores de Windows. |
| Encabezado | wwan.h (incluye Wwan.h) |