Compartir a través de


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)

Consulte también

NDIS_WWAN_SET_CONTEXT_STATE

WWAN_ACTIVATION_COMMAND

WWAN_AUTH_PROTOCOL

WWAN_COMPRESSION