estrutura NDIS_WWAN_CONTEXT_STATE (ndiswwan.h)

  • Artigo

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

Sintaxe

typedef struct _NDIS_WWAN_CONTEXT_STATE {
  NDIS_OBJECT_HEADER Header;
  WWAN_STATUS        uStatus;
  WWAN_CONTEXT_STATE ContextState;
} NDIS_WWAN_CONTEXT_STATE, *PNDIS_WWAN_CONTEXT_STATE;

Membros

Header

O cabeçalho com informações de tipo, revisão e tamanho sobre a estrutura NDIS_WWAN_CONTEXT_STATE. O Serviço MB define o cabeçalho com os valores mostrados na tabela a seguir quando envia a estrutura de dados para o driver de miniporto para operações definidas . Os drivers de miniport devem definir o cabeçalho com os mesmos valores quando enviarem a estrutura de dados para o serviço MB.

Submember de cabeçalho Valor
Tipo NDIS_OBJECT_TYPE_DEFAULT
Revisão Windows 8 miniportores devem definir isso como NDIS_WWAN_CONTEXT_STATE_REVISION_2. Os drivers de miniporto do Windows 7 devem definir isso como NDIS_WWAN_CONTEXT_STATE_REVISION_1.
Tamanho sizeof(NDIS_WWAN_CONTEXT_STATE)
 

Para obter mais informações sobre esses membros, consulte NDIS_OBJECT_HEADER.

uStatus

O status da operação de ativação ou desativação de contexto. A tabela a seguir mostra os valores possíveis para esse membro.

Valor Significado
WWAN_STATUS_SUCCESS Ativação ou desativação de contexto bem-sucedida.
WWAN_STATUS_FAILURE Falha na operação. Os drivers de miniport podem retornar esse valor se o contexto já tiver sido ativado.
WWAN_STATUS_PIN_REQUIRED A operação falhou porque o dispositivo requer um PIN.
WWAN_STATUS_BAD_SIM A operação falhou porque um cartão SIM inválido foi detectado.
WWAN_STATUS_SIM_NOT_INSERTED A operação falhou porque a cartão sim não foi totalmente inserida no dispositivo.
WWAN_STATUS_NOT_INITIALIZED A operação falhou porque o dispositivo está em processo de inicialização. Repita a operação após o estado pronto do dispositivo ser alterado para WwanReadyStateInitialized.
 

Os drivers de miniport podem retornar os seguintes códigos de erro (além daqueles descritos anteriormente) somente no caso de uma operação de ativação PDP definida com falha.

Valor Significado
WWAN_STATUS_RADIO_POWER_OFF A operação falhou porque o rádio está desativado no momento. Esse código de erro deve ser retornado somente em resposta a uma solicitação OID_WWAN_CONNECT definida . Se o estado de rádio estiver desativado, o driver de miniporto deverá responder a OID_WWAN_CONNECT solicitações de consulta com WWAN_STATUS_SUCCESS e especificar o estado de contexto atual como WwanActivationStateDeactivated.
WWAN_STATUS_SERVICE_NOT_ACTIVATED A operação falhou porque a assinatura expirou ou o dispositivo não permite ativação PDP.
WWAN_STATUS_PROVIDER_NOT_VISIBLE A operação falhou porque o provedor de serviços não está visível no momento.
WWAN_STATUS_MAX_ACTIVATED_CONTEXTS A operação falhou porque o número máximo de contextos ativados foi atingido.
WWAN_STATUS_INVALID_ACCESS_STRING A operação falhou porque a cadeia de caracteres de acesso é inválida.
WWAN_STATUS_INVALID_USER_NAME_PWD A operação falhou porque o nome de usuário e/ou a senha fornecidos são inválidos. O código de erro específico da rede pode estar disponível em uNwError .
WWAN_STATUS_PACKET_SVC_DETACHED A operação falhou porque o serviço de pacotes está desanexado.
WWAN_STATUS_NOT_REGISTERED A operação falhou porque o dispositivo não está no estado registrado para executar a ativação PDP.
WWAN_STATUS_VOICE_CALL_IN_PROGRESS A operação falhou e não pode continuar com a ativação PDP porque uma chamada de voz está em andamento no momento. Esse valor se aplica somente a dispositivos com classe de voz definido como WwanVoiceClassSeparateVoiceData.
WWAN_STATUS_CONTEXT_NOT_ACTIVATED A operação falhou porque o contexto identificado por ConnectionId não é o contexto ativado no momento.

ContextState

Um objeto WWAN_CONTEXT_STATE formatado que representa o estado de contexto PDP (Packet Data Protocol) do dispositivo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 7 e versões posteriores do Windows.
Cabeçalho ndiswwan.h (inclua Ndiswwan.h)

Confira também

NDIS_OBJECT_HEADER

WWAN_CONTEXT_STATE