MBN_INTERFACE_CAPS 구조체(mbnapi.h)

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 값에 대한 추가 정보를 제공합니다.

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 값에 대한 추가 정보를 제공합니다.

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을 호출하여 이 문자열을 해제해야 합니다.

요구 사항