다음을 통해 공유

MBN_INTERFACE_CAPS 구조체(mbnapi.h)

  • 아티클

중요

Windows 10 버전 1803부터 이 섹션에 설명된 Win32 API는 Windows.Networking.Connectivity 네임스페이스의 Windows 런타임 API로 대체됩니다.

MBN_INTERFACE_CAPS 구조체는 인터페이스 기능을 나타냅니다. 이 구조체는 IMbnInterface의 GetInterfaceCapability 메서드에 의해 반환됩니다.

구문

typedef struct MBN_INTERFACE_CAPS {
  MBN_CELLULAR_CLASS cellularClass;
  MBN_VOICE_CLASS    voiceClass;
  ULONG              dataClass;
  BSTR               customDataClass;
  ULONG              gsmBandClass;
  ULONG              cdmaBandClass;
  BSTR               customBandClass;
  ULONG              smsCaps;
  ULONG              controlCaps;
  BSTR               deviceID;
  BSTR               manufacturer;
  BSTR               model;
  BSTR               firmwareInfo;
} MBN_INTERFACE_CAPS;

멤버

cellularClass

디바이스에서 사용하는 셀룰러 기술을 지정하는 MBN_CELLULAR_CLASS 값입니다.

voiceClass

음성 통화 처리 방법을 지정하는 MBN_VOICE_CLASS 값입니다.

dataClass

지원되는 데이터 서비스를 지정하는 MBN_DATA_CLASS 값의 비트 OR 조합입니다. GSM 디바이스의 경우 GSM 기반 데이터 서비스만 존재할 수 있습니다. 즉, GPRS, EDGE, UMTS, LTE 및 HSDPA만 GSM 디바이스에 유효한 값입니다.

CDMA 디바이스의 경우 CDMA 관련 데이터 서비스만 존재합니다. 즉, 1xRTT, 1xEV-DO 및 1xEV-DO RevA만 CDMA 디바이스에 유효한 값입니다. 1xEV-DO RevB는 나중에 사용하도록 예약되어 있습니다.

이 필드에는 데이터 클래스가 열거형에 정의되지 않은 다른 데이터 클래스도 디바이스에서 지원되는 경우 MBN_DATA_CLASS_CUSTOM 비트 값이 설정됩니다. MBN_DATA_CLASS_CUSTOM 설정된 경우 customDataClass 필드에서 사용자 지정 데이터 클래스에 대한 정보를 사용할 수 있습니다.

customDataClass

사용자 지정 데이터 클래스의 이름을 포함합니다. dataClass의 MBN_DATA_CLASS_CUSTOM 비트가 설정되지 않은 경우 문자열은 NULL입니다. 그렇지 않으면 호출자는 SysFreeString을 호출하여 이 문자열을 해제해야 합니다.

gsmBandClass

GSM 디바이스에서 지원하는 빈도 대역을 지정하는 비트 필드입니다. MBN_BAND_CLASS_X 및 MBN_BAND_CLASS_CUSTOM 통해 MBN_BAND_CLASS_I 유효한 값입니다. 이러한 값은 MBN_BAND_CLASS 정의됩니다. gsmBandClass가 MBN_BAND_CLASS_CUSTOM 설정된 경우 밴드 클래스에 대한 추가 정보가 customBandClass에 표시됩니다.

다음 표에서는 MBN_BAND_CLASS 값에 대한 추가 정보를 제공합니다.

MBN_BAND_CLASS 값 지정된 스펙트럼 업계 이름 업링크(MS에서 BTS로) 다운링크(BTS에서 MS로) 영역
MBN_BAND_CLASS_I UMTS2100 Imt 1920-1980 2110-2170 유럽, 한국, 일본 중국
MBN_BAND_CLASS_II UMT21900 PCS1900 1850-1910 1930-1990 북아메리카, 라틴 아메리카
MBN_BAND_CLASS_III UMTS1800 DCS1800 1710-1785 1805-1880 유럽, 중국
MBN_BAND_CLASS_IV AWS AWS, 1.7/2.1 1710-1785 2110-2155 북아메리카, 라틴 아메리카
MBN_BAND_CLASS_V UMTS850 GSM850 824-849 869-894 북아메리카, 라틴 아메리카
MBN_BAND_CLASS_VI UMTS800 UMTS800 830-840 875-885 일본
MBN_BAND_CLASS_VII UMTS2600 UMTS2600 2500-2570 2620-2690 유럽
MBN_BAND_CLASS_VIII UMTS900 EGSM900 880-915 925-960 유럽, 중국
MBN_BAND_CLASS_IX UMTS1700 UMTS1700 1750-1770 1845-1880 일본
MBN_BAND_CLASS_X 1710-1770 2110-2170

cdmaBandClass

CDMA 디바이스에서 지원하는 빈도 대역을 지정하는 비트 필드입니다. MBN_BAND_CLASS_XVII , MBN_BAND_CLASS_NONE 및 MBN_BAND_CLASS_CUSTOM 통해 MBN_BAND_CLASS_0 유효한 값입니다. 이러한 값은 MBN_BAND_CLASS 정의됩니다. cdmaBandClass가 MBN_BAND_CLASS_CUSTOM 설정된 경우 밴드 클래스에 대한 추가 정보가 customBandClass에 표시됩니다.

다음 표에서는 MBN_BAND_CLASS 값에 대한 추가 정보를 제공합니다.

MBN_BAND_CLASS 값 업계 이름 업링크(MS에서 BTS로) 다운링크(BTS에서 MS로)
MBN_BAND_CLASS_0 800MHx 셀룰러 824.025.844.995 869.025.889.995
MBN_BAND_CLASS_I 1900MHz 대역 1850-1910 1930-1990
MBN_BAND_CLASS_II TACS 밴드 872.025.914.9875 917.0125.959.9875
MBN_BAND_CLASS_III JTACS 밴드 887.0125.924.9875 832.0125.869.9875
MBN_BAND_CLASS_IV 한국어 PCS 밴드 1750-1780 1840-1870
MBN_BAND_CLASS_V 450MHz 대역 410-483.475 420-493.475
MBN_BAND_CLASS_VI 2GHz 대역 1920-1979.950 2110-2169.950
MBN_BAND_CLASS_VII 700MHz 대역 776-794 746-764
MBN_BAND_CLASS_VIII 1800MHz 대역 1710-1784.950 1805-1879.95
MBN_BAND_CLASS_IX 900MHz 대역 880-914-950 925-959.950
MBN_BAND_CLASS_X 보조 800MHz 대역 806-900.975 851-939.975
MBN_BAND_CLASS_XI 400MHz 유럽 PAMR 밴드 410-483.475 420-493.475
MBN_BAND_CLASS_XII 800MHz PAMR 밴드 870.125-875.9875 915.0125-920.9875
MBN_BAND_CLASS_XIII 2.5GHz IMT200 확장 대역 2500-2570 2620-2690
MBN_BAND_CLASS_XIV 미국 PCS 1.9GHz 대역 1850-1915 1930-1995
MBN_BAND_CLASS_XV AWS 밴드 1710-1755 2110-2155
MBN_BAND_CLASS_XVI 미국 2.5GHz 대역 2502-2568 2624-2690
MBN_BAND_CLASS_XVII US 2.5GHz Forward Link Only Band 2624-2690

customBandClass

사용자 지정 밴드 클래스의 이름을 포함합니다. cdmaBandClass 및 gsmBandClass의 MBN_BAND_CLASS_CUSTOM 비트가 설정되지 않은 경우 문자열은 NULL입니다. 그렇지 않으면 호출자는 SysFreeString을 호출하여 이 문자열을 해제해야 합니다.

smsCaps

SMS 기능을 지정하는 MBN_SMS_CAPS 값의 비트 OR 조합입니다.

controlCaps

이 인터페이스의 모바일 광대역 제어 기능을 나타내는 MBN_CTRL_CAPS 값의 비트 OR 조합입니다.

deviceID

디바이스 ID를 포함합니다. GSM 디바이스의 경우 IMEI(최대 15자리)여야 합니다. CDMA 디바이스의 경우 ESN(11자리) /MEID(17자리)여야 합니다. 문자열의 최대 길이는 MBN_DEVICEID_LEN. MBN_DEVICEID_LEN 정의는 MBN_INTERFACE_CAPS_CONSTANTS 참조하세요. 호출자는 SysFreeString을 호출하여 이 문자열을 해제해야 합니다.

manufacturer

디바이스 제조업체의 이름을 포함합니다. 이 문자열은 비어 있을 수 있습니다. 문자열의 최대 길이는 MBN_MANUFACTURER_LEN. MBN_MANUFACTURER_LEN 정의는 MBN_INTERFACE_CAPS_CONSTANTS 참조하세요. 호출자는 SysFreeString을 호출하여 이 문자열을 해제해야 합니다.

model

디바이스 모델을 포함합니다. 이 문자열은 비어 있을 수 있습니다. 이 문자열의 최대 길이는 MBN_MODEL_LEN. MBN_MODEL_LEN 정의는 MBN_INTERFACE_CAPS_CONSTANTS 참조하세요. 호출자는 SysFreeString을 호출하여 이 문자열을 해제해야 합니다.

firmwareInfo

이 디바이스에 대한 펌웨어 관련 정보를 포함합니다. 이 문자열은 비어 있을 수 있습니다. 문자열의 최대 길이는 MBN_FIRMWARE_LEN. MBN_FIRMWARE_LEN 정의는 MBN_INTERFACE_CAPS_CONSTANTS 참조하세요. 호출자는 SysFreeString을 호출하여 이 문자열을 해제해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 지원되는 버전 없음
머리글 mbnapi.h