estrutura WWAN_CONTEXT_STATE (wwan.h)

A estrutura WWAN_CONTEXT_STATE representa o estado de contexto PDP (Packet Data Protocol) do dispositivo MB.

Sintaxe

typedef struct _WWAN_CONTEXT_STATE {
  ULONG                    uNwError;
  ULONG                    ConnectionId;
  WWAN_ACTIVATION_STATE    ActivationState;
  WWAN_VOICE_CALL_STATE    VoiceCallState;
  WWAN_IP_TYPE             IPType;
  WWAN_CONNECTION_MEDIA    ConnectionMedia;
  WCHAR                    AccessString[WWAN_ACCESSSTRING_LEN];
  WWAN_SINGLE_NSSAI        Snssai;
  ULONG                    FoundMatchingConnectionId;
  WWAN_OFFSET_SIZE_ELEMENT TrafficParameters;
} WWAN_CONTEXT_STATE, *PWWAN_CONTEXT_STATE;

Membros

uNwError

Um erro específico da rede. A tabela a seguir mostra os valores de falha de conexão, conforme documentado na Especificação 3GPP TS 24.008.

Código de causa 3GPP 24.008	Interpretação do código de causa
8 – Barramento determinado pelo operador	O serviço de dados de pacotes é bloqueado pelo operador .
26 – Recursos insuficientes	O contexto não pode ser ativado devido a recursos insuficientes na rede.
27 – APN (nome do ponto de acesso) ausente ou desconhecido	Nenhum APN ou APN desconhecido é fornecido na solicitação de ativação.
29 , 30, 31 – Falha na autenticação do usuário	Nome de usuário ou senha incorreto fornecido na solicitação de ativação.
32 – Opção de serviço sem suporte	O GPRS não é compatível com a rede.
33 – A opção serviço solicitado não está assinada	O GPRS (serviço solicitado) não é assinado pelo usuário.
34 – A opção serviço está temporariamente fora de ordem	O serviço de dados de pacotes está temporariamente fora de ordem. O usuário deve tentar novamente mais tarde.
43 – Contexto PDP (Protocolo de Dados de Pacote Desconhecido)	Nenhum APN ou APN desconhecido é fornecido na solicitação de ativação.

ConnectionId

O Serviço MB especifica um valor para esse membro no momento da solicitação de conexão usando OID_WWAN_CONNECT. Os drivers de miniporto devem copiar esse valor e usá-lo quando notificarem o Serviço MB sobre alterações subsequentes no estado de conexão.

ActivationState

O estado de ativação atual do dispositivo.

VoiceCallState

O estado atual da chamada de voz do dispositivo.

IPType

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

ConnectionMedia

O tipo de mídia para um contexto/sessão estabelecido.

AccessString[WWAN_ACCESSSTRING_LEN]

O APN/DNN selecionado para um contexto/sessão estabelecido.

Snssai

Uma estrutura WWAN_SINGLE_NSSAI que representa uma única NSSAI (Informações de Assistência de Seleção de Fatia de Rede).

FoundMatchingConnectionId

Válido somente se o status for WWAN_STATUS_SESSION_ALREADY_EXISTS.

TrafficParameters

Uma estrutura WWAN_OFFSET_SIZE_ELEMENT . Válido somente se o status for WWAN_STATUS_DESSOCIATION_NEEDED_FOR_APPLICATION. Os primeiros 4 bytes são o deslocamento para o DataBuffer que contém os dados brutos de MBIM_TLV_TYPE_TRAFFIC_PARAMETERS, em bytes, calculados desde o início do WWAN_SET_CONTEXT_STATE. Os segundos 4 bytes são o tamanho dos dados brutos de MBIM_TLV_TYPE_TRAFFIC_PARAMETERS, em bytes.

Comentários

Definir Solicitações OID, bem como eventos de status não solicitados, usam o membro uNwError. Se não houver nenhum erro específico de rede ou o erro específico da rede não for conhecido, os drivers de miniporto deverão definir esse membro como 0.

Os pontos a seguir fornecem diretrizes sobre como retornar um erro específico de rede em cenários diferentes:

• Se uma solicitação definida falhar, os drivers de miniporto deverão retornar o código de erro específico da rede. Nesse caso, o driver de miniporte deve definir o membro uStatus da estrutura NDIS_WWAN_CONTEXT_STATE como WWAN_STATUS_FAILURE ou um erro mais específico, como WWAN_STAUS_INVALID_ACCESS_STRING ou WWAN_STATUS_INVALID_USER_NAME_PWD, e definir o membro uNwError como o código de erro específico da rede.
• Sempre que o estado de ativação do contexto do dispositivo for alterado devido à desativação do contexto iniciado pela rede, os eventos de status não solicitados devem incluir o erro específico da rede. Nesse caso, o driver de miniporto deve definir o membro uStatus da estrutura NDIS_WWAN_CONTEXT_STATE como WWAN_STATUS_SUCCESS e definir o membro uNwError como o código de erro específico da rede.

Os drivers de miniport podem fornecer códigos de erro adicionais, conforme definido pela especificação de padrões GSM de códigos de erro de ativação de contexto retornados pela rede. Por exemplo, os drivers de miniporto podem comunicar os códigos de erro de ativação de contexto TS 24.008 de especificação 3GPP, como o código de erro 8 (barramento determinado pelo operador), ao Serviço MB por meio do membro uNwError . Não há nenhum padrão disponível para códigos de erro específicos de rede baseados em CDMA. Dispositivos e redes baseados em CDMA podem retornar informações de código de erro específicas da rede usando o membro uNwError .

No caso de resposta ao NDIS_WWAN_SET_CONTEXT_STATE, use esse membro para fornecer códigos de erro adicionais retornados pela rede.

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_CONTEXT_STATE

WWAN_ACTIVATION_STATE

WWAN_VOICE_CALL_STATE