estrutura WWAN_SET_CONTEXT_STATE (wwan.h)

A estrutura WWAN_SET_CONTEXT_STATE representa o comando para definir o estado de contexto PDP (Protocolo de Dados de Pacote) do dispositivo MB.

Sintaxe

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;

Membros

ConnectionId

O Serviço MB especifica esse membro para identificar exclusivamente o Contexto PDP e seu estado correspondente.

O Serviço MB usa o valor neste membro para identificar exclusivamente o contexto ativo atual entre adaptadores de rede MB.

O driver de miniporta deve usar o valor neste membro ao concluir solicitações de conjunto . O Serviço MB usa o valor nesse membro em solicitações de consulta subsequentes, bem como solicitações de desconexão para o driver de miniporto.

ActivationCommand

Ativar ou desativar um contexto PDP referenciado no membro ConnectionId . A tabela a seguir mostra os valores possíveis que um driver de miniporto pode especificar.

Valor	Significado
WwanActivationCommandActivate	Ative o contexto PDP referenciado por ConnectionId .
WwanActivationCommandDeactivate	Desativar um contexto PDP ativado no momento referenciado por ConnectionId .

AccessString[WWAN_ACCESSSTRING_LEN]

Uma cadeia de caracteres terminada em NULL para acessar a rede. Para redes baseadas em GSM, essa seria uma cadeia de caracteres APN (Nome do Ponto de Acesso), como "data.thephone-company.com". Para redes baseadas em CDMA, esse pode ser um código de discagem especial, como "#777" ou um NAI (Identificador de Acesso à Rede), como "foo@thephone-company.com". Esse membro pode ser NULL.

O tamanho da cadeia de caracteres não deve exceder 100 bytes.

UserName[WWAN_USERNAME_LEN]

Uma cadeia de caracteres terminada em NULL que representa o nome de usuário a ser autenticado. Esse membro pode ser NULL.

Password[WWAN_PASSWORD_LEN]

Uma cadeia de caracteres terminada em NULL que representa a senha do nome de usuário. Esse membro pode ser NULL.

Compression

Um valor da enumeração WWAN_COMPRESSION que especifica se a compactação deve ser usada na conexão de dados para cabeçalho e dados. Esse membro se aplica somente a dispositivos baseados em GSM. O Serviço MB define esse membro como WwanCompressionNone para dispositivos baseados em CDMA.

Valor	Significado
WwanCompressionNone	Nenhuma compactação é aplicada.
WwanCompressionEnable	Habilite o cabeçalho e a compactação de dados.

AuthType

Um valor da enumeração WWAN_AUTH_PROTOCOL que especifica o tipo de autenticação a ser usado para a ativação PDP. Esse membro se aplica somente a dispositivos baseados em GSM. O Serviço MB define esse membro como WwanAuthProtocolNone para dispositivos baseados em CDMA.

Valor	Significado
WwanAuthProtocolNone	Nenhum protocolo de autenticação.
WwanAuthProtocolPap	Autenticação de senha não criptografada.
WwanAuthProtocolChap	Use o CHAP (Challenge Handshake Authentication Protocol).
WwanAuthProtocolMsChapV2	Use o CHAP (Microsoft Challenge Handshake Authentication Protocol) v2.0.

IPType

Um valor da enumeração WWAN_IP_TYPE que especifica o tipo de IP.

MediaPreference

ConnectionMediaSource

ActivationOption

Um valor da enumeração WWAN_ACTIVATION_OPTION que representa as opções de ativação PDP (Protocolo de Dados de Pacote) compatíveis com o dispositivo MB.

Snssai

Uma estrutura WWAN_SINGLE_NSSAI que representa uma única NSSAI (Network Slice Selection Assistance Information).

TrafficParameters

Uma estrutura WWAN_OFFSET_SIZE_ELEMENT . Os primeiros 4 bytes são o deslocamento para o DataBuffer que contém os dados brutos de MBIM_TLV_TYPE_TRAFFIC_PARAMETERS campo de dados, em bytes, calculados desde o início do WWAN_SET_CONTEXT_STATE. Os segundos 4 bytes são do tamanho dos dados brutos de MBIM_TLV_TYPE_TRAFFIC_PARAMETERS campo de dados, em bytes.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível em Windows 8 e versões posteriores do Windows.
Cabeçalho	wwan.h (inclua Wwan.h)

Confira também

NDIS_WWAN_SET_CONTEXT_STATE

WWAN_ACTIVATION_COMMAND

WWAN_AUTH_PROTOCOL

WWAN_COMPRESSION