estrutura WWAN_READY_INFO_REV1 (wwan.h)

Artigo
08/08/2023

A estrutura WWAN_READY_INFO_REV1 representa o estado pronto do dispositivo MB. WWAN_READY_INFO_REV1 atualiza WWAN_READY_INFO removendo o campo StatusFlags .

Sintaxe

typedef struct _WWAN_READY_INFO_REV1 {
  WWAN_READY_STATE    ReadyState;
  WWAN_EMERGENCY_MODE EmergencyMode;
  WCHAR               SubscriberId[WWAN_SUBSCRIBERID_LEN];
  WCHAR               SimIccId[WWAN_SIMICCID_LEN];
  BYTE                CdmaShortMsgSize;
  WWAN_LIST_HEADER    TNListHeader;
} WWAN_READY_INFO_REV1, *PWWAN_READY_INFO_REV1;

Membros

ReadyState

O estado pronto do dispositivo.

EmergencyMode

O modo de emergência do dispositivo. Para obter mais informações, consulte WWAN_EMERGENCY_MODE.

SubscriberId[WWAN_SUBSCRIBERID_LEN]

Uma cadeia de caracteres terminada em NULL de dígitos que representa a identidade do assinante.

Para dispositivos baseados em GSM, esse membro representa a cadeia de caracteres IMSI (Identidade Internacional do Assinante Móvel) (até 15 dígitos de comprimento).

Para dispositivos baseados em CDMA, isso representa a cadeia de caracteres MIN (Número de Identificação Móvel) ou a cadeia de caracteres IRM (International Roaming MIN) (ambos com 10 dígitos de comprimento).

Os drivers de miniport devem especificar essa cadeia de caracteres quando o estado pronto do dispositivo for alterado para WwanReadyStateInitialized. Os drivers de miniporto também devem especificar essa cadeia de caracteres quando o estado pronto do dispositivo for alterado para WwanReadyStateBadSim, WwanReadyStateFailure ou WwanReadyStateDeviceLocked, se possível, para fins de identificação.

Para funções de vários modos de operadora única, o formato SubscriberId do GSM deve ser usado. Isso não se aplica a funções multi-modo de várias operadoras, pois a SubscriberId pode ser alterada.

SimIccId[WWAN_SIMICCID_LEN]

Uma cadeia de caracteres terminada em NULL de dígitos que representa a ID do ICC (International Circuit Card) do SIM. A ID do ICC varia de 15 a 20 dígitos de comprimento e é representada em caracteres alfanuméricos. Os drivers de miniporto devem especificar essa cadeia de caracteres quando o estado pronto do dispositivo for alterado para WwanReadyStateInitialized e também quando o dispositivo estiver bloqueado, aguardando a entrada das chaves PIN1 e PUK1.

Os drivers de miniport devem especificar esse valor para todos os dispositivos em que WwanCellularClass é igual a WwanCellularClassGsm. Drivers de miniporte de dispositivos baseados em CDMA devem especificar esse valor para dispositivos em que SimClass é igual a WwanSimClassSimRemovable.

CdmaShortMsgSize

O comprimento do caractere SMS compatível com a rede ou o dispositivo, o que for menor, se o dispositivo for baseado em CDMA.

Os dispositivos baseados em CDMA que dão suporte a SMS devem especificar o tamanho máximo de caracteres SMS específico da operadora para serem maiores que WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN e menores que WWAN_CDMA_SHORT_MSG_SIZE_MAX.

Dispositivos baseados em CDMA que não dão suporte a SMS devem definir esse membro como WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.

Esse membro não se aplica a dispositivos baseados em GSM. Drivers de miniporta de dispositivos baseados em GSM devem especificar WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.

TNListHeader

Uma lista de TNs (números de telefone) atribuídos à identidade do assinante.

Cada elemento na lista é uma cadeia de caracteres de WCHARs, com um tamanho fixo de WWAN_TN_LEN.

Cada TN armazenado em um elemento de lista é um valor terminado em NULL.

Em dispositivos baseados em GSM, as TNs são chamadas de MSISDNs (Número ISDN da Estação Móvel). Em dispositivos baseados em CDMA, eles são chamados de MDNs (Números de Diretório Móvel).

Os drivers de miniporta não devem especificar esse valor até que o estado pronto do dispositivo seja alterado para WwanReadyStateInitialized.