WWAN_DEVICE_CAPS_EX 구조체(wwan.h)

WWAN_DEVICE_CAPS_EX 구조는 모바일 광대역 디바이스의 기능을 나타냅니다. WWAN_DEVICE_CAPS_EX Microsoft 서비스 확장에 대해 특정 실행기를 추적하기 위한 Executor Index 멤버 및 WwanOptionalServiceCaps 멤버를 추가하여 기존 WWAN_DEVICE_CAPS 구조를 확장합니다.

구문

typedef struct _WWAN_DEVICE_CAPS_EX {
  WWAN_DEVICE_TYPE    WwanDeviceType;
  WWAN_CELLULAR_CLASS WwanCellularClass;
  WWAN_VOICE_CLASS    WwanVoiceClass;
  WWAN_SIM_CLASS      WwanSimClass;
  ULONG               WwanDataClass;
  WCHAR               CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN];
  ULONG               WwanGsmBandClass;
  ULONG               WwanCdmaBandClass;
  WCHAR               CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN];
  ULONG               WwanSmsCaps;
  ULONG               WwanControlCaps;
  WCHAR               DeviceId[WWAN_DEVICEID_LEN];
  WCHAR               Manufacturer[WWAN_MANUFACTURER_LEN];
  WCHAR               Model[WWAN_MODEL_LEN];
  WCHAR               FirmwareInfo[WWAN_FIRMWARE_LEN];
  ULONG               MaxActivatedContexts;
  ULONG               WwanAuthAlgoCaps;
  ULONG               ExecutorIndex;
  ULONG               WwanOptionalServiceCaps;
  ULONG               WwanSimClassBitMasks;
  ULONG               WwanWCDMABandClass;
  USHORT              WwanLTEBandClass[WWAN_MAX_NUM_LTE_BAND];
  USHORT              WwanNRBandClass[WWAN_MAX_NUM_NR_BAND];
  ULONGLONG           WwanDataSubClass;
  ULONGLONG           WwanMiscCaps;
  WWAN_LIST_HEADER    CellularClassListHeader;
} WWAN_DEVICE_CAPS_EX, *PWWAN_DEVICE_CAPS_EX;

멤버

WwanDeviceType

디바이스의 유형입니다. 미니포트 드라이버는 디바이스 유형을 WwanDeviceTypeUnknown 이외의 값으로 설정해야 합니다.

WwanCellularClass

디바이스의 셀룰러 클래스입니다. 미니포트 드라이버는 셀룰러 클래스를 WwanCellularClassUnknown 이외의 값으로 설정해야 합니다. 이 멤버의 값은 네트워크 공급자 등록 모드와 같은 셀룰러 기술과 관련된 기능을 제어합니다.

다중 모드를 지원하는 미니포트 드라이버는 이를 WwanCellularClassGsm으로 설정해야 합니다.

WwanVoiceClass

디바이스의 음성 클래스입니다. 이 멤버는 회로 음성 서비스의 존재와 이러한 서비스가 데이터 서비스와 상호 작용하는 방법에 대해 MB 서비스에 알릴 수 있습니다. MB 서비스는 회로 전환 음성을 기본적으로 지원하지 않으며 이를 배제하지도 않습니다. 회로 음성을 지원하는 방법을 결정하는 것은 미니포트 드라이버의 입니다. 이 WwanVoiceClass 멤버를 사용하면 MB 서비스가 나중에 이 기능을 지원할 수 있습니다.

WwanSimClass

WWAN_SIM_CLASS 열거형에 지정된 SIM 카드(구독자 ID 모듈)의 클래스입니다. 미니포트 드라이버는 SIM 클래스를 WwanSimClassUnknown 이외의 값으로 설정해야 합니다.

WwanDataClass

디바이스에서 지원하는 데이터 클래스를 나타내는 비트맵입니다. 다음 표에서는 이 멤버에 대해 가능한 값을 보여 있습니다.

CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN]

사용자 지정 데이터 클래스의 이름을 나타내는 NULL로 끝나는 문자열입니다. 이 멤버는 미니포트 드라이버가 WwanDataClass 멤버에서 WWAN_DATA_CLASS_CUSTOM 비트를 설정하는 경우에만 유효합니다.

WwanGsmBandClass

GSM 기반 디바이스에서 지원하는 주파수 대역을 나타내는 비트맵입니다. 다음 표에서는 이 멤버에 대해 가능한 값을 보여 있습니다.

미니포트 드라이버가 WWAN_BAND_CLASS_CUSTOM 지정하는 경우 CustomBandClass 에서 데이터 클래스의 이름도 제공해야 합니다.

이러한 값에 대한 자세한 내용은 OID_WWAN_DEVICE_CAPS.

WwanCdmaBandClass

CDMA 기반 디바이스에서 지원하는 빈도 대역을 나타내는 비트맵입니다. 다음 표에서는 이 멤버에 대해 가능한 값을 보여 있습니다.

미니포트 드라이버가 WWAN_BAND_CLASS_CUSTOM 지정하는 경우 CustomBandClass 에서 데이터 클래스의 이름도 제공해야 합니다.

이러한 값에 대한 자세한 내용은 OID_WWAN_DEVICE_CAPS.

CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN]

사용자 지정 밴드 클래스의 이름을 나타내는 NULL로 끝나는 문자열입니다. 이 멤버는 미니포트 드라이버가 WwanGsmBandClass 또는 WwanCdmaBandClass 멤버에서 WWAN_BAND_CLASS_CUSTOM 비트를 적절하게 설정하는 경우에만 유효합니다.

WwanSmsCaps

디바이스에서 지원하는 SMS 메시지 및 방향 흐름의 유형을 나타내는 비트맵입니다. 다음 표에서는 유효한 SMS 기능 설정을 보여줍니다.

미니포트 드라이버는 현재 홈 공급자가 다중 모드를 사용할 수 있는 경우 SMS를 수신하고 보내기 위한 GSM PDU 형식에 대한 지원만 반영하도록 이 멤버를 설정해야 합니다. 따라서 미니포트 드라이버가 셀룰러 클래스 네이티브 형식(예: CDMA TEXT 또는 CDMA PDU)으로 SMS를 수신하는 경우 미니포트 드라이버는 GSM PDU로 변환을 수행하고 MB 서비스에 표시해야 합니다. 마찬가지로 미니포트 드라이버가 GSM PDU 형식의 송신 요청을 수신하는 경우 기본 셀룰러 클래스 형식으로 변환해야 합니다.

WwanControlCaps

디바이스에서 지원하는 제어 기능을 나타내는 비트맵입니다. 다음 표에서는 GSM 기반 및 CDMA 기반 디바이스에 대한 유효한 WwanControlCaps 설정을 보여 줍니다.

CDMA 기반 디바이스의 미니포트 드라이버는 디바이스가 지원하는 IP 유형에 대해 MB 서비스에 알리기 위해 WWAN_CTRL_CAPS_CDMA_MOBILE_IP 또는 WWAN_CTRL_CAPS_CDMA_SIMPLE_IP 또는 두 플래그를 모두 지정해야 합니다.

DeviceId[WWAN_DEVICEID_LEN]

디바이스 ID를 나타내는 NULL로 종료된 문자열입니다.

GSM 기반 디바이스의 경우 문자열은 IMEI(International Mobile Equipment Identity) 형식(최대 15자리)을 준수해야 합니다.

CDMA 기반 디바이스의 경우 문자열은 전자 일련 번호(ESN, 11자리) 및 모바일 장비 식별자(MEID, 17자리) 형식을 모두 준수해야 합니다.

다중 모드 지원 미니포트 드라이버(예: WwanControlCaps에서 WWAN_CTRL_CAPS_MULTI_MODE 플래그를 설정하는 드라이버)의 경우 GSM 기반 DeviceId만 보고해야 합니다.

이 값은 디바이스의 메모리에 저장되어야 하며 잠금을 해제하기 위해 MB 디바이스/SIM에 PIN이 필요한 경우에도 사용할 수 있어야 합니다.

Manufacturer[WWAN_MANUFACTURER_LEN]

디바이스 제조업체를 나타내는 NULL로 끝나는 문자열입니다. 이 멤버는 선택 사항입니다.

Model[WWAN_MODEL_LEN]

디바이스의 모델을 나타내는 NULL로 끝나는 문자열입니다. 이 멤버는 선택 사항입니다.

FirmwareInfo[WWAN_FIRMWARE_LEN]

디바이스에 대한 펌웨어 관련 정보를 나타내는 NULL로 끝나는 문자열입니다. 이 멤버는 선택 사항입니다.

MaxActivatedContexts

디바이스에서 지원하는 활성화된 컨텍스트의 최대 수입니다. 미니포트 드라이버는 MaxActivatedContexts를 초과하는 활성화 시도에 실패하여 이 제한을 적용해야 합니다.

WwanAuthAlgoCaps

MB 디바이스에서 지원하는 인증 방법 유형을 나타내는 비트맵입니다.

ExecutorIndex

WWAN_DEVICE_CAPS_EX 대한 WwanDeviceType 멤버는 더 이상 모뎀 디바이스가 아니라 개별 실행기를 참조합니다. 각 디바이스는 OS가 인식하는 RF 실행기 엔터티입니다.

WwanOptionalServiceCaps

기본 모뎀이 지원하는 Microsoft 서비스 확장을 나타내는 ULONG 구조체입니다. 정의되지 않은 비트가 예약되어 있고 "0"으로 설정되어야 하는 64비트 비트맵 구조체입니다. 새 서비스 확장이 도입되면 예약된 비트가 새 서비스 확장을 나타내는 데 사용됩니다.

WwanSimClassBitMasks

SIM 클래스 마스크를 나타내는 비트맵입니다. 최소한 WwanSimClass 필드에 해당하는 마스크를 포함해야 합니다.

WwanWCDMABandClass

FDD용 3GPP TS25.101에 정의된 밴드 번호입니다. LSB는 대역 번호 1(2100MHz)을 나타냅니다.

WwanLTEBandClass[WWAN_MAX_NUM_LTE_BAND]

WwanNRBandClass[WWAN_MAX_NUM_NR_BAND]

WwanDataSubClass

디바이스에서 지원하는 데이터 서브클래스를 나타내는 비트맵입니다.

WwanMiscCaps

디바이스에서 지원하는 기타 기능을 나타내는 비트맵입니다. |값| |--- | |WWAN_DEVICE_MISC_CAPS_NONE 0x00000000| |WWAN_DEVICE_MISC_CAPS_ETHERNET_PDU_SESSION 0x00000001| |WWAN_DEVICE_MISC_CAPS_UNSTRUCTURED_PDU_SESSION 0x00000002| |WWAN_DEVICE_MISC_CAPS_ESIM 0x00000004| |WWAN_DEVICE_MISC_CAPS_REFLECTIVE_QOS 0x00000008|

CellularClassListHeader

다중 모드 지원 디바이스에서 지원하는 셀룰러 클래스 목록을 나타내는 형식이 지정된 WWAN_LIST_HEADER 개체입니다. WWAN_LIST_HEADER ElementType 멤버는 항상 WwanStructCellularClass로 설정해야 합니다. WWAN_LIST_HEADER ElementCount 멤버는 WWAN_LIST_HEADER 구조를 따르는 셀룰러 클래스의 수로 설정됩니다. 다중 모드가 지원되지 않는 MB 디바이스는 ElementCount 를 0으로 설정해야 합니다.

설명

미니포트 드라이버는 디바이스에서 지원하는 데이터 서비스가 WwanDataClass 멤버의 테이블에 정의된 다른 값에 속하지 않는 경우 WWAN_DATA_CLASS_CUSTOM 지정해야 합니다. 미니포트 드라이버가 WWAN_DATA_CLASS_CUSTOM 플래그를 설정하는 경우 미니포트 드라이버는 CustomDataClass 멤버에서 데이터 클래스의 이름도 제공해야 합니다.

GSM 기반 디바이스의 경우 GSM 기반 데이터 클래스만 지정해야 합니다. 예를 들어 GPRS, EDGE, UMTS, HSDPA, LTE 및 TD-SCDMA가 있습니다. 미니포트 드라이버가 TD-SCDMA를 지원하는 경우 WwanDataClass 멤버의 WWAN_DATA_CLASS_CUSTOM CustomDataClass 멤버의 문자열 "TD-SCDMA"를 지정해야 합니다.

CDMA 기반 디바이스의 경우 CDMA 관련 데이터 서비스만 지정해야 합니다. 예를 들어 1xRTT, 1xEV-DO, 1xEV-DO RevA 및 UMB입니다. 1xEV-DO RevB는 나중에 사용하도록 정의됩니다. 완전성을 위해 1xEV-DV 및 3xRTT도 정의됩니다.

요구 사항

추가 정보

NDIS_WWAN_DEVICE_CAPS_EX

OID_WWAN_DEVICE_CAPS_EX

WWAN_DEVICE_CAPS