WWAN_REGISTRATION_STATE 구조체(wwan.h)

아티클
01/10/2024

WWAN_REGISTRATION_STATE 구조체는 MB 디바이스의 등록 상태를 나타냅니다.

구문

typedef struct _WWAN_REGISTRATION_STATE {
  ULONG               uNwError;
  WWAN_REGISTER_STATE RegisterState;
  WWAN_REGISTER_MODE  RegisterMode;
  WCHAR               ProviderId[WWAN_PROVIDERID_LEN];
  WCHAR               ProviderName[WWAN_PROVIDERNAME_LEN];
  WCHAR               RoamingText[WWAN_ROAMTEXT_LEN];
  DWORD               WwanRegFlags;
  WWAN_CELLULAR_CLASS CurrentCellularClass;
  ULONG               PreferredDataClasses;
} WWAN_REGISTRATION_STATE, *PWWAN_REGISTRATION_STATE;

멤버

uNwError

등록 실패 시 네트워크 관련 오류입니다. 이 멤버에 대한 자세한 내용은 다음 "주의" 섹션을 참조하세요.

RegisterState

디바이스의 등록 상태입니다. 정의된 값 목록은 WWAN_REGISTER_STATE 참조하세요.

WwanRegisterStatePartner 값은 디바이스가 기본 파트너 네트워크 공급자에서 로밍 중임을 나타내고 WwanRegisterStateRoaming 값은 디바이스가 로밍 중임을 나타냅니다. 로밍 상태의 파트너 특성을 사용할 수 없는 경우 미니포트 드라이버는 WwanRegisterStateRoaming을 보고해야 합니다.

RegisterMode

디바이스의 등록 모드입니다. 정의된 값 목록은 WWAN_REGISTER_MODE 참조하세요.

ProviderId[WWAN_PROVIDERID_LEN]

네트워크 공급자 ID를 나타내는 NULL로 끝나는 숫자(0-9) 문자열입니다.

GSM 기반 네트워크의 경우 이 문자열은 3자리 MCC(모바일 국가 코드)와 2자리 또는 3자리 MNC(모바일 네트워크 코드)를 연결한 것입니다. GSM 기반 이동 통신 사업자에는 둘 이상의 MNC가 있을 수 있으며, 따라서 둘 이상의 ProviderId 가 있을 수 있습니다.

CDMA 기반 네트워크의 경우 이 문자열은 5자리 SID(시스템 ID)입니다. 일반적으로 CDMA 기반 이동 통신 사업자에는 둘 이상의 SID가 있습니다. 일반적으로 운송업체는 각 시장에 대해 하나의 SID를 가지고 있으며, 일반적으로 미국 미국 MSA(메트로폴리탄 통계 영역)와 같은 규정에 따라 국가 내에서 지리적으로 나뉩니다. CDMA 기반 디바이스의 미니포트 드라이버는 이 정보를 사용할 수 없는 경우 WWAN_CDMA_DEFAULT_PROVIDER_ID 지정해야 합니다.

쿼리 요청을 처리하고 등록 상태가 자동 등록 모드인 경우 이 멤버는 디바이스가 현재 연결되어 있는 공급자 ID(해당하는 경우)를 포함합니다. 등록 상태가 수동 등록 모드인 경우 이 멤버에는 디바이스가 등록하도록 요청된 공급자 ID가 포함됩니다(공급자를 사용할 수 없는 경우에도).

설정된 요청을 처리하고 등록 상태가 수동 모드인 경우 등록할 디바이스에 대해 MB 서비스에서 선택한 공급자 ID가 포함됩니다. 등록 상태가 자동 등록 모드인 경우 이 매개 변수는 무시됩니다.

공급자 ID를 사용할 수 없는 경우 CDMA 1xRTT 공급자를 WWAN_CDMA_DEFAULT_PROVIDER_ID 설정해야 합니다.

ProviderName[WWAN_PROVIDERNAME_LEN]

네트워크 공급자의 이름을 나타내는 NULL로 끝나는 문자열입니다. 이 멤버는 최대 WWAN_PROVIDERNAME_LEN 문자로 제한됩니다.

GSM 기반 네트워크의 경우 국가 이니셜 및 모바일 네트워크 이름(PPCI&N)의 기본 프레젠테이션이 20자보다 긴 경우 미니포트 드라이버는 네트워크 이름을 약어로 사용해야 합니다.

이 멤버는 MB 서비스가 기본 설정 공급자 목록을 설정하는 경우 무시됩니다.

미니포트 드라이버는 이 정보가 없는 디바이스에 대해 NULL 문자열을 지정해야 합니다.

RoamingText[WWAN_ROAMTEXT_LEN]

디바이스가 로밍 중임을 사용자에게 알리는 NULL로 종료된 문자열입니다. 이 멤버는 최대 WWAN_ROAMTEXT_LEN 문자로 제한됩니다.

등록 상태가 WwanRegisterStatePartner 또는 WwanRegisterStateRoaming인 경우 이 텍스트는 사용자에게 추가 정보를 제공해야 합니다. 이 멤버는 선택 사항입니다.

WwanRegFlags

등록 플래그.

값	의미
WWAN_REG_FLAGS_NONE	등록 플래그가 없습니다.
WWAN_REG_FLAGS_NO_MANUAL_REG	수동 연결이 없습니다.
WWAN_REG_FLAGS_PS_AUTO_ATTACH	MB 디바이스가 자체 패킷 컨텍스트를 관리한다는 것을 나타냅니다. MB 서비스는 미니포트 드라이버에 패킷 분리를 보내지 않지만 패킷 연결을 보낼 수 있습니다.

CurrentCellularClass

등록된 네트워크의 현재 셀룰러 클래스입니다. 단일 셀룰러 클래스만 지원하는 네트워크의 경우 이 멤버를 해당 셀룰러 클래스로 설정해야 합니다. 다중 모드 지원 네트워크의 경우 미니포트 드라이버는 네트워크가 셀룰러 클래스를 변경할 때 MB 서비스에 NDIS_STATUS_WWAN_REGISTER_STATE 알림을 보냅니다.

PreferredDataClasses

연결에 선호되는 데이터 액세스 기술을 나타내는 비트 마스크입니다.

설명

OID 요청을 쿼리 및 설정하고 원치 않는 상태 이벤트는 uNwError 멤버를 사용합니다. 네트워크별 오류가 없거나 네트워크별 오류를 알 수 없는 경우 미니포트 드라이버는 이 멤버를 0으로 설정해야 합니다. MB 운영 의미 체계의 "상태 표시 구조" 섹션에는 3GPP TS 24.008 사양에 정의된 등록 원인 코드 오류 값이 표시됩니다.

다음 사항은 다양한 시나리오에서 네트워크별 오류를 반환하는 지침을 제공합니다.

네트워크별 오류로 인해 네트워크 등록이 실패하는 경우 미니포트 드라이버는 쿼리 요청에 대한 응답으로 네트워크별 오류를 반환해야 합니다. 이 경우 미니포트 드라이버는 NDIS_WWAN_REGISTRATION_STATE 구조체의 uStatus 멤버를 WWAN_STATUS_SUCCESS 설정하고 uNwError 멤버를 네트워크별 오류 코드로 설정해야 합니다.
설정된 요청이 실패하면 미니포트 드라이버는 네트워크별 오류 코드를 반환해야 합니다. 이 경우 미니포트 드라이버는 NDIS_WWAN_REGISTRATION_STATE 구조의 uStatus 멤버를 WWAN_STATUS_FAILURE 설정하고 uNwError 멤버를 네트워크별 오류 코드로 설정해야 합니다.
네트워크가 디바이스 등록을 취소하기 때문에 디바이스 등록 상태가 변경될 때마다(예: 디바이스의 구독이 만료되어 네트워크가 디바이스 등록을 취소함) 원치 않는 상태 이벤트에 네트워크별 오류가 포함되어야 합니다. 이 경우 미니포트 드라이버는 NDIS_WWAN_REGISTRATION_STATE 구조체의 uStatus 멤버를 WWAN_STATUS_SUCCESS 설정하고 uNwError 멤버를 네트워크별 오류 코드로 설정해야 합니다.

OID_WWAN_REGISTER_STATE 요청을 처리할 때 네트워크별 오류를 반환하려면 미니포트 드라이버는 NDIS_WWAN_REGISTRATION_STATE 구조의 uStatus 멤버를 WWAN_STATUS_FAILURE 설정하고 uNwError 멤버를 네트워크별 오류 코드로 설정해야 합니다.

미니포트 드라이버는 네트워크에서 반환된 패킷 연결 오류 코드의 GSM 표준 사양에 정의된 추가 오류 코드를 제공할 수 있습니다. 예를 들어 미니포트 드라이버는 uNwError 멤버를 통해 오류 코드 12(위치 영역 허용 안 됨)와 같은 3GPP 사양 TS 24.008 패킷 연결 오류 코드를 MB 서비스에 전달할 수 있습니다.

미니포트 드라이버는 가능한 한 빨리 instance 원인 코드를 보고해야 합니다. 예를 들어 네트워크 공급자에 디바이스를 등록하려고 할 때 MB 디바이스에서 이러한 코드 중 하나가 발생하는 경우 미니포트 드라이버는 해당 시간에 이를 보고해야 합니다.

다중 모드 네트워크에 연결된 미니포트 드라이버는 NDIS_STATUS_WWAN_REGISTER_STATE 알림을 통해 셀룰러 클래스 변경을 나타내야 합니다.