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