WWAN_READY_INFO 구조체(wwan.h)

아티클
08/08/2023

WWAN_READY_INFO 구조체는 MB 디바이스의 준비 상태를 나타냅니다.

구문

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;

멤버

ReadyState

디바이스의 준비 상태입니다.

EmergencyMode

디바이스의 비상 모드입니다. 자세한 내용은 WWAN_EMERGENCY_MODE 참조하세요.

SubscriberId[WWAN_SUBSCRIBERID_LEN]

구독자의 ID를 나타내는 NULL로 끝나는 숫자 문자열입니다.

GSM 기반 디바이스의 경우 이 멤버는 IMSI(International Mobile Subscriber Identity) 문자열(최대 15자리 길이)을 나타냅니다.

CDMA 기반 디바이스의 경우 MIN(모바일 식별 번호) 문자열 또는 IRM(International Roaming MIN) 문자열(둘 다 10자리 길이)을 나타냅니다.

미니포트 드라이버는 디바이스 준비 상태가 WwanReadyStateInitialized로 변경될 때 이 문자열을 지정해야 합니다. 미니포트 드라이버는 디바이스 준비 상태가 식별 목적으로 WwanReadyStateBadSim, WwanReadyStateFailure 또는 WwanReadyStateDeviceLocked로 변경되는 경우에도 이 문자열을 지정해야 합니다.

단일 캐리어 다중 모드 함수의 경우 GSM SubscriberId 형식을 사용해야 합니다. SubscriberId가 변경 될 수 있으므로 다중 통신 사업자 다중 모드 함수에는 적용되지 않습니다.

SimIccId[WWAN_SIMICCID_LEN]

SIM의 ICC(International Circuit Card) ID를 나타내는 NULL로 끝나는 숫자 문자열입니다. ICC ID는 길이가 15~20자리 사이이며 영숫자로 표시됩니다. 미니포트 드라이버는 디바이스 준비 상태가 WwanReadyStateInitialized 로 변경되고 디바이스가 잠겨 있을 때 PIN1 및 PUK1 키의 입력을 기다리는 경우 이 문자열을 지정해야 합니다.

미니포트 드라이버는 WwanCellularClass가 WwanCellularClassGsm과 같은 모든 디바이스에 대해 이 값을 지정해야 합니다. CDMA 기반 디바이스의 미니포트 드라이버는 SimClass 가 WwanSimClassSimRemovable과 같은 디바이스에 대해 이 값을 지정해야 합니다.

CdmaShortMsgSize

디바이스가 CDMA 기반인 경우 네트워크 또는 디바이스에서 지원하는 SMS 문자 길이입니다.

SMS를 지원하는 CDMA 기반 디바이스는 통신 사업자별 최대 SMS 문자 길이를 WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN 보다 크고 WWAN_CDMA_SHORT_MSG_SIZE_MAX 미만으로 지정해야 합니다.

SMS를 지원하지 않는 CDMA 기반 디바이스는 이 멤버를 WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN 설정해야 합니다.

이 멤버는 GSM 기반 디바이스에 적용되지 않습니다. GSM 기반 디바이스의 미니포트 드라이버는 WWAN_CDMA_SHORT_MSG_SIZE_UNKNOWN 지정해야 합니다.

StatusFlags

SIM 상태 플래그.

값	의미
WWAN_READY_STATUS_MASK_IS_ESIM 0x00000001	0: 현재 SIM이 eSIM이 아닙니다. 1: 현재 SIM은 eSIM입니다. ReadyState가 MBIMSubscriberReadyStateInitialized 또는 MBIMSubscriberReadyStateNoEsimProfile인 경우에만 유효합니다.
WWAN_READY_STATUS_MASK_SIM_REMOVABILITY_KNOWN 0x00000002	0: SIM 이동 가능성을 알 수 없습니다. 1: SIM 이동성이 알려져 있습니다.
WWAN_READY_STATUS_MASK_SIM_FORMFACTOR 0x00000004	0: 현재 SIM이 포함됩니다. 1: 현재 SIM이 이동식입니다. ReadyState가 MBIMSubscriberReadyStateInitialized, MBIMSubscriberReadyStateNoEsimProfile 또는 MBIMSubscriberReadyStateDeviceLocked인 경우에만 유효합니다.
WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE 0x00000008	0: 표시는 현재 비활성 슬롯에서 나왔습니다. 1: 표시는 현재 활성 슬롯에서 나왔습니다. 이 비트는 WWAN_READY_STATUS_MASK_MASKS_IS_VALID 비트와 독립적으로 설정할 수 있습니다.
WWAN_READY_STATUS_MASK_MASKS_IS_VALID 0x80000000	다른 상태 비트(WWAN_READY_STATUS_MASK_SIM_SLOT_ACTIVE 제외)가 잘못된지 여부를 나타냅니다. 비트가 0이면 다른 비트가 유효하지 않으며 무시해야 합니다. 비트가 1이면 다른 상태 비트가 유효합니다.