estructura WWAN_READY_INFO (wwan.h)

La estructura WWAN_READY_INFO representa el estado listo del dispositivo MB.

Sintaxis

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;

Miembros

ReadyState

Estado listo del dispositivo.

EmergencyMode

Modo de emergencia del dispositivo. Para obtener más información, consulte WWAN_EMERGENCY_MODE.

SubscriberId

Cadena terminada en NULL de dígitos que representa la identidad del suscriptor.

En el caso de los dispositivos basados en GSM, este miembro representa la cadena de identidad de suscriptor móvil internacional (IMSI) (hasta 15 dígitos de longitud).

En el caso de los dispositivos basados en XAML, representa la cadena Número de identificación móvil (MIN) o la cadena International Roaming MIN (IRM) (ambos de 10 dígitos de longitud).

Los controladores miniport deben especificar esta cadena cuando el estado listo del dispositivo cambie a WwanReadyStateInitialized. Los controladores miniport también deben especificar esta cadena cuando el estado listo del dispositivo cambie a WwanReadyStateBadSim, WwanReadyStateFailure o WwanReadyStateDeviceLocked, si es posible, con fines de identificación.

En el caso de las funciones de varios modos de operador único, se debe usar el formato subscriberId GSM. Esto no se aplica a las funciones multi-operador multi-mode, ya que subscriberId puede cambiar.

SimIccId

Cadena terminada en NULL de dígitos que representa el identificador de tarjeta de circuito internacional (ICC) de la SIM. El id. de ICC varía de entre 15 y 20 dígitos de longitud y se representa en caracteres alfanuméricos. Los controladores miniport deben especificar esta cadena cuando el estado listo del dispositivo cambia a WwanReadyStateInitialized y también cuando el dispositivo está bloqueado, esperando la entrada de las teclas PIN1 y PUK1.

Los controladores miniport deben especificar este valor para todos los dispositivos en los que WwanClassClass es igual a WwanClassGsm. Los controladores miniporte de dispositivos basados en NULL deben especificar este valor para los dispositivos en los que SimClass es igual a WwanSimClassSimRemovable.

CdmaShortMsgSize

Longitud de caracteres SMS compatible con la red o el dispositivo, lo que sea menor, si el dispositivo está basado en EQUIVALE.

Los dispositivos basados en NULL que admiten SMS deben especificar su longitud máxima máxima de caracteres SMS específica del operador para que sea mayor que WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN y menor que WWAN_CDMA_SHORT_MSG_SIZE_MAX.

Los dispositivos basados en JAILBREAK que no admiten SMS deben establecer este miembro en WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.

Este miembro no se aplica a los dispositivos basados en GSM. Los controladores miniporte de dispositivos basados en GSM deben especificar WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN.

StatusFlags

Marcas de estado de SIM.

Valor Significado
WWAN_READY_STATUS_MASK_IS_ESIM 0x00000001 0: La SIM actual no es un eSIM. 1: La SIM actual es un eSIM. Válido solo cuando ReadyState es MBIMSubscriberReadyStateInitialized o MBIMSubscriberReadyStateNoEsimProfile.
WWAN_READY_STATUS_MASK_SIM_REMOVABILITY_KNOWN 0x00000002 0: Se desconoce la capacidad de comunicación remota de SIM. 1: Se conoce la capacidad de comunicación remota de SIM.
WWAN_READY_STATUS_MASK_SIM_FORMFACTOR 0x00000004 0: La SIM actual está incrustada. 1: La SIM actual es extraíble. Válido solo cuando ReadyState es MBIMSubscriberReadyStateInitialized, MBIMSubscriberReadyStateNoEsimProfile o MBIMSubscriberReadyStateDeviceLocked.
WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE 0x00000008 0: La indicación procede de la ranura actualmente inactiva. 1: La indicación procede de la ranura activa actualmente. Este bit puede establecerse independientemente del bit de WWAN_READY_STATUS_MASK_MASKS_IS_VALID.
WWAN_READY_STATUS_MASK_MASKS_IS_VALID 0x80000000 Indica si otros bits de estado (excepto para WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE) no son válidos. Si el bit es 0, otros bits no son válidos y deben omitirse. Si el bit es 1, otros bits de estado son válidos.

SlotId

Valor de ULONG que especifica el identificador de ranura de tarjeta SIM.

TNListHeader

Lista de números de teléfono (TN) que se asignan a la identidad del suscriptor.

Cada elemento de la lista es una cadena de WCHAR, con un tamaño fijo de WWAN_TN_LEN.

Cada TN almacenado en un elemento de lista es un valor terminado en NULL.

En los dispositivos basados en GSM, los TN se denominan número ISDN de la estación móvil (MSISDN). En los dispositivos basados en XAML se denominan números de directorio móvil (MDN).

Los controladores miniport no deben especificar este valor hasta que el estado listo del dispositivo cambie a WwanReadyStateInitialized.

Requisitos

   
Cliente mínimo compatible Disponible en Windows 7 y versiones posteriores de Windows.
Header wwan.h (incluya Wwan.h)

Consulte también

NDIS_WWAN_READY_INFO

WWAN_EMERGENCY_MODE

WWAN_LIST_HEADER

WWAN_READY_STATE