estrutura WWAN_READY_INFO (wwan.h)

Artigo
08/08/2023

A estrutura WWAN_READY_INFO representa o estado pronto do dispositivo MB.

Sintaxe

typedef struct _WWAN_READY_INFO {
  WWAN_READY_STATE    ReadyState;
  WWAN_EMERGENCY_MODE EmergencyMode;
  WCHAR               SubscriberId[WWAN_SUBSCRIBERID_LEN];
  WCHAR               SimIccId[WWAN_SIMICCID_LEN];
  BYTE                CdmaShortMsgSize;
  ULONG               StatusFlags;
  ULONG               SlotId;
  WWAN_LIST_HEADER    TNListHeader;
} WWAN_READY_INFO, *PWWAN_READY_INFO;

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 de dígitos terminada em NULL 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 miniport 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 GSM SubscriberId deve ser usado. Isso não se aplica a funções multi-modo de várias operadoras, pois a SubscriberId pode mudar.

SimIccId[WWAN_SIMICCID_LEN]

Uma cadeia de caracteres de dígitos terminada em NULL que representa a ID do CCI (Cartão de Circuito Internacional) 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. Os drivers de miniport 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 comprimento 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. Os drivers de miniporte de dispositivos baseados em GSM devem especificar WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.

StatusFlags

Sinalizadores de status sim.

Valor	Significado
WWAN_READY_STATUS_MASK_IS_ESIM 0x00000001	0: O SIM atual não é um eSIM. 1: o SIM atual é um eSIM. Válido somente quando o ReadyState for MBIMSubscriberReadyStateInitialized ou MBIMSubscriberReadyStateNoEsimProfile.
WWAN_READY_STATUS_MASK_SIM_REMOVABILITY_KNOWN 0x00000002	0: A removebilidade do SIM é desconhecida. 1: a removebilidade do SIM é conhecida.
WWAN_READY_STATUS_MASK_SIM_FORMFACTOR 0x00000004	0: O SIM atual está inserido. 1: O SIM atual é removível. Válido somente quando o ReadyState for MBIMSubscriberReadyStateInitialized, MBIMSubscriberReadyStateNoEsimProfile ou MBIMSubscriberReadyStateDeviceLocked.
WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE 0x00000008	0: A indicação veio do slot inativo no momento. 1: A indicação veio do slot ativo no momento. Esse bit pode ser definido independentemente do bit WWAN_READY_STATUS_MASK_MASKS_IS_VALID.
WWAN_READY_STATUS_MASK_MASKS_IS_VALID 0x80000000	Indica se outros bits de status (exceto WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE) são inválidos. Se o bit for 0, outros bits serão inválidos e deverão ser ignorados. Se o bit for 1, outros bits status serão válidos.

SlotId

Um valor ULONG que especifica o SIM cartão ID do slot.

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 encerrado 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 miniporte não devem especificar esse valor até que o estado pronto do dispositivo seja alterado para WwanReadyStateInitialized.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows 7 e versões posteriores do Windows.
Cabeçalho	wwan.h (inclua Wwan.h)

Confira também