estrutura NDIS_WWAN_PACKET_SERVICE_STATE (ndiswwan.h)

  • Artigo

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)

Confira também

NDIS_OBJECT_HEADER

WWAN_PACKET_SERVICE