estrutura NDIS_WWAN_PACKET_SERVICE_STATE (ndiswwan.h)
A estrutura NDIS_WWAN_PACKET_SERVICE_STATE representa o estado do anexo do serviço de pacotes do dispositivo MB.
Sintaxe
typedef struct _NDIS_WWAN_PACKET_SERVICE_STATE {
NDIS_OBJECT_HEADER Header;
WWAN_STATUS uStatus;
WWAN_PACKET_SERVICE PacketService;
} NDIS_WWAN_PACKET_SERVICE_STATE, *PNDIS_WWAN_PACKET_SERVICE_STATE;
Membros
Header
O cabeçalho com informações de tipo, revisão e tamanho sobre a estrutura NDIS_WWAN_PACKET_SERVICE_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 ao 5G definem isso como NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_2. Os drivers de miniport que não dão suporte a 5G ou que são para versões anteriores do Windows definem isso como NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_1. |
| Tamanho | sizeof(NDIS_WWAN_PACKET_SERVICE_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 de solicitações de conjunto e consulta .
WWAN_STATUS_SUCCESS deverá ser retornado pelo driver de miniporte, se o estado solicitado e o estado atual forem iguais para uma solicitação definida .
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 ou definir o estado do serviço de pacotes. |
| 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_SIM_NOT_INSERTED | A operação falhou porque a cartão sim não foi totalmente inserida no dispositivo. |
| WWAN_STATUS_BAD_SIM | A operação falhou porque um cartão SIM inválido foi detectado. |
Os drivers de miniport podem retornar os códigos de erro (além dos listados acima) mostrados na tabela a seguir caso uma solicitação de conjunto de anexação de pacotes falhe.
| Valor | Significado |
|---|---|
| WWAN_STATUS_FAILURE | Falha na anexação de pacotes ou desanexação de pacotes. Mais informações são definidas em uNwError membro da estrutura WWAN_PACKET_SERVICE. Para outros erros de WWAN_STATUS_XXX, uNwError deve ser definido como zero. |
| WWAN_STATUS_SERVICE_NOT_ACTIVATED | O dispositivo não permite definir o estado do serviço de pacotes devido a uma falha de ativação de serviço ou assinatura expirada. |
| WWAN_STATUS_PROVIDER_NOT_VISIBLE | O provedor não está visível para operações de serviço de pacotes. |
| WWAN_STATUS_NOT_REGISTERED | O dispositivo não está no estado registrado para executar uma operação de anexação de pacotes. |
| WWAN_STATUS_NO_DEVICE_SUPPORT | Não há suporte para o serviço de pacote SET neste dispositivo baseado em CDMA. |
| WWAN_STATUS_RADIO_POWER_OFF | Não é possível anexar pacotes porque o rádio está desativado. |
| WWAN_STATUS_SIM_NOT_INSERTED | Uma cartão sim não está inserida. |
| WWAN_STATUS_BAD_SIM | Uma cartão SIM incorreta é detectada. |
PacketService
Um objeto WWAN_PACKET_SERVICE formatado que representa o estado do anexo do serviço de pacotes 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) |