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) |