estrutura NDIS_WWAN_PACKET_SERVICE_STATE (ndiswwan.h)
A estrutura NDIS_WWAN_PACKET_SERVICE_STATE representa o estado do anexo do serviço de pacote 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 definir operações de. Os drivers de miniporto devem definir o cabeçalho com os mesmos valores quando enviarem a estrutura de dados para o serviço MB.
| Submembro de cabeçalho | Valor |
|---|---|
| Tipo | NDIS_OBJECT_TYPE_DEFAULT |
| Revisão | Os drivers de miniporto do Windows 10, 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 ao 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 está definido para a execução bem-sucedida de definir e solicitações de consulta.
WWAN_STATUS_SUCCESS deverá ser retornado pelo driver de miniporto, se o estado solicitado e o estado atual forem iguais para uma solicitação definida.
A tabela a seguir mostra os outros códigos de status de erro possíveis.
| Valor | Significado |
|---|---|
| WWAN_STATUS_PIN_REQUIRED | O dispositivo requer entrada de valor PIN. |
| WWAN_STATUS_FAILURE | Não é possível obter ou definir o estado do serviço de pacote. |
| 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 mudar para WwanReadyStateInitialized . |
| WWAN_STATUS_SIM_NOT_INSERTED | A operação falhou porque o cartão SIM não foi totalmente inserido 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 um conjunto de de anexação de pacotes solicitação falhe.
| Valor | Significado |
|---|---|
| WWAN_STATUS_FAILURE | Falha ao anexar pacotes ou desanexar 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 pacote devido à falha de ativação do serviço ou à assinatura expirada. |
| WWAN_STATUS_PROVIDER_NOT_VISIBLE | O provedor não é visível para operações de serviço de pacote. |
| 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 | Um cartão SIM não está inserido. |
| WWAN_STATUS_BAD_SIM | Um cartão SIM incorreto é detectado. |
PacketService
Um objeto WWAN_PACKET_SERVICE formatado que representa o estado do anexo do serviço de pacote do dispositivo MB.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows 7 e versões posteriores do Windows. |
| cabeçalho | ndiswwan.h (inclua Ndiswwan.h) |