estrutura NDIS_WWAN_CONTEXT_STATE (ndiswwan.h)
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) |