Share via

WWAN_READY_INFO_REV2_PRE2170 구조체(wwan.h)

  • 아티클

WWAN_READY_INFO_REV2_PRE2170 구조체는 Windows 11 이전의 WWAN_READY_INFO 구조체의 이전 버전입니다.

구문

typedef struct _WWAN_READY_INFO_REV2_PRE2170 {
  WWAN_READY_STATE    ReadyState;
  WWAN_EMERGENCY_MODE EmergencyMode;
  WCHAR               SubscriberId[WWAN_SUBSCRIBERID_LEN];
  WCHAR               SimIccId[WWAN_SIMICCID_LEN];
  BYTE                CdmaShortMsgSize;
  ULONG               StatusFlags;
  WWAN_LIST_HEADER    TNListHeader;
} WWAN_READY_INFO_REV2_PRE2170, *PWWAN_READY_INFO_PRE2170;

멤버

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이면 다른 상태 비트가 유효합니다.

TNListHeader

구독자 ID에 할당된 TN(전화 번호) 목록입니다.

목록의 각 요소는 고정 크기가 WWAN_TN_LEN WCHAR 문자열입니다.

목록 요소에 저장된 각 TN은 NULL로 종료된 값입니다.

GSM 기반 디바이스에서 TN을 MSISDN(Mobile Station ISDN 번호)이라고 합니다. CDMA 기반 디바이스에서는 MDN(모바일 디렉터리 번호)이라고 합니다.

미니포트 드라이버는 디바이스 준비 상태가 WwanReadyStateInitialized로 변경될 때까지 이 값을 지정하지 않아야 합니다.

요구 사항

요구 사항 값
헤더 wwan.h

추가 정보

WWAN_READY_INFO