Compartilhar via

estrutura NDIS_WWAN_REGISTRATION_STATE (ndiswwan.h)

  • Artigo

A estrutura NDIS_WWAN_REGISTRATION_STATE representa o estado de registro do dispositivo MB.

Sintaxe

typedef struct _NDIS_WWAN_REGISTRATION_STATE {
  NDIS_OBJECT_HEADER      Header;
  WWAN_STATUS             uStatus;
  WWAN_REGISTRATION_STATE RegistrationState;
} NDIS_WWAN_REGISTRATION_STATE, *PNDIS_WWAN_REGISTRATION_STATE;

Membros

Header

O cabeçalho com informações de tipo, revisão e tamanho sobre a estrutura NDIS_WWAN_REGISTRATION_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 10, os drivers de miniporte versão 1903 que dão suporte a um dispositivo 5G devem definir isso como NDIS_WWAN_REGISTRATION_STATE_REVISION_3. Windows 8 miniportores devem definir isso como NDIS_WWAN_REGISTRATION_STATE_REVISION_2. Os drivers de miniporto do Windows 7 devem definir isso como NDIS_WWAN_REGISTRATION_STATE_REVISION_1.
Tamanho sizeof(NDIS_WWAN_REGISTRATION_STATE)
 

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

uStatus

Um driver de miniporto deve definir isso como WWAN_STATUS_SUCCESS para eventos não solicitados (NDIS_STATUS_INDICATION::RequestId = 0). WWAN_STATUS_SUCCESS também é definido para a execução bem-sucedida do NDIS_WWAN_SET_REGISTER_STATE.

A tabela a seguir mostra o outro possível erro status códigos.

Valor Significado
WWAN_STATUS_PIN_REQUIRED O dispositivo requer entrada de valor de PIN.
WWAN_STATUS_FAILURE Não é possível obter o estado de registro.
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.
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.
 

Os drivers de miniport podem retornar os seguintes códigos de erro (além dos listados acima) somente caso uma operação de conjunto de ativação PDP falhe.

Valor Significado
WWAN_STATUS_FAILURE Não é possível definir o estado de registro. Mais informações são especificadas em uNwError . Para outros códigos de erro, uNwError deve ser definido como 0.
WWAN_STATUS_NO_DEVICE_SUPPORT Os dispositivos baseados em CDMA devem retornar esse código de erro se uma solicitação de registro definida for para registro manual.
WWAN_STATUS_SERVICE_NOT_ACTIVATED Falha na ativação do serviço. A assinatura expirou. O dispositivo não permite definir o estado de registro.
WWAN_STATUS_PROVIDER_NOT_VISIBLE O provedor não está visível para registro. Isso é para registro manual.
WWAN_STATUS_INVALID_PARAMETERS Se a solicitação for um registro manual para um provedor proibido.
WWAN_STATUS_BUSY O dispositivo está ocupado e não consegue alterar o modo de registro. Esse cenário poderá ocorrer se o dispositivo não permitir a alteração do modo de registro quando um contexto PDP for ativado.

RegistrationState

Um objeto WWAN_REGISTRATION_STATE formatado que representa o estado de registro do dispositivo MB.

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_REGISTRATION_STATE