WWAN_SET_CONTEXT_STATE 구조체(wwan.h)
WWAN_SET_CONTEXT_STATE 구조는 MB 디바이스의 PDP(패킷 데이터 프로토콜) 컨텍스트 상태를 설정하는 명령을 나타냅니다.
구문
typedef struct _WWAN_SET_CONTEXT_STATE {
ULONG ConnectionId;
WWAN_ACTIVATION_COMMAND ActivationCommand;
WCHAR AccessString[WWAN_ACCESSSTRING_LEN];
WCHAR UserName[WWAN_USERNAME_LEN];
WCHAR Password[WWAN_PASSWORD_LEN];
WWAN_COMPRESSION Compression;
WWAN_AUTH_PROTOCOL AuthType;
WWAN_IP_TYPE IPType;
WWAN_PSMEDIA_PREFERENCE MediaPreference;
WWAN_CONFIGURATION_SOURCE ConnectionMediaSource;
WWAN_ACTIVATION_OPTION ActivationOption;
WWAN_SINGLE_NSSAI Snssai;
WWAN_OFFSET_SIZE_ELEMENT TrafficParameters;
} WWAN_SET_CONTEXT_STATE, *PWWAN_SET_CONTEXT_STATE;
멤버
ConnectionId
MB 서비스는 PDP 컨텍스트 및 해당 상태를 고유하게 식별하도록 이 멤버를 지정합니다.
MB 서비스는 이 멤버의 값을 사용하여 MB 네트워크 어댑터에서 현재 활성 컨텍스트를 고유하게 식별합니다.
미니포트 드라이버는 집합 요청을 완료할 때 이 멤버의 값을 사용해야 합니다. MB 서비스는 후속 쿼리 요청에서 이 멤버의 값을 사용하고 미니포트 드라이버에 대한 요청의 연결을 끊습니다.
ActivationCommand
ConnectionId 멤버에서 참조되는 PDP 컨텍스트를 활성화하거나 비활성화합니다. 다음 표에서는 미니포트 드라이버가 지정할 수 있는 가능한 값을 보여 주세요.
| 값 | 의미 |
|---|---|
| WwanActivationCommandActivate | ConnectionId 에서 참조하는 PDP 컨텍스트를 활성화합니다. |
| WwanActivationCommandDeactivate | ConnectionId 에서 참조하는 현재 활성화된 PDP 컨텍스트를 비활성화합니다. |
AccessString[WWAN_ACCESSSTRING_LEN]
네트워크에 액세스하기 위한 NULL로 종료된 문자열입니다. GSM 기반 네트워크의 경우 "data.thephone-company.com"과 같은 APN(액세스 지점 이름) 문자열입니다. CDMA 기반 네트워크의 경우 "#777"과 같은 특수 다이얼 코드 또는 "foo@thephone-company.com"와 같은 NAI(네트워크 액세스 식별자)일 수 있습니다. 이 멤버는 NULL일 수 있습니다.
문자열의 크기는 100바이트를 초과하면 안 됩니다.
UserName[WWAN_USERNAME_LEN]
인증할 사용자 이름을 나타내는 NULL로 끝나는 문자열입니다. 이 멤버는 NULL일 수 있습니다.
Password[WWAN_PASSWORD_LEN]
사용자 이름의 암호를 나타내는 NULL로 끝나는 문자열입니다. 이 멤버는 NULL일 수 있습니다.
Compression
헤더 및 데이터에 대한 데이터 연결에서 압축을 사용해야 하는지 여부를 지정하는 WWAN_COMPRESSION 열거형의 값입니다. 이 멤버는 GSM 기반 디바이스에만 적용됩니다. MB 서비스는 CDMA 기반 디바이스의 경우 이 멤버를 WwanCompressionNone 으로 설정합니다.
| 값 | 의미 |
|---|---|
| WwanCompressionNone | 압축이 적용되지 않습니다. |
| WwanCompressionEnable | 헤더 및 데이터 압축을 사용하도록 설정합니다. |
AuthType
PDP 활성화에 사용할 인증 유형을 지정하는 WWAN_AUTH_PROTOCOL 열거형의 값입니다. 이 멤버는 GSM 기반 디바이스에만 적용됩니다. MB 서비스는 CDMA 기반 디바이스에 대해 이 멤버를 WwanAuthProtocolNone 으로 설정합니다.
| 값 | 의미 |
|---|---|
| WwanAuthProtocolNone | 인증 프로토콜이 없습니다. |
| WwanAuthProtocolPap | 암호화되지 않은 암호 인증. |
| WwanAuthProtocolChap | CHAP(Challenge Handshake Authentication Protocol)를 사용합니다. |
| WwanAuthProtocolMsChapV2 | MICROSOFT CHALLENGE CHAP(핸드셰이크 인증 프로토콜) v2.0을 사용합니다. |
IPType
IP 유형을 지정하는 WWAN_IP_TYPE 열거형의 값입니다.
MediaPreference
ConnectionMediaSource
ActivationOption
MB 디바이스에서 지원하는 PDP(패킷 데이터 프로토콜) 활성화 옵션을 나타내는 WWAN_ACTIVATION_OPTION 열거형의 값입니다.
Snssai
단일 NSSAI(네트워크 조각 선택 지원 정보)를 나타내는 WWAN_SINGLE_NSSAI 구조체입니다.
TrafficParameters
WWAN_OFFSET_SIZE_ELEMENT 구조체입니다. 처음 4바이트는 WWAN_SET_CONTEXT_STATE 시작부터 계산된 MBIM_TLV_TYPE_TRAFFIC_PARAMETERS 데이터 필드의 원시 데이터를 포함하는 DataBuffer에 대한 오프셋(바이트)입니다. 두 번째 4바이트는 MBIM_TLV_TYPE_TRAFFIC_PARAMETERS 데이터 필드의 원시 데이터 크기(바이트)입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 이상 버전의 Windows에서 사용할 수 있습니다. |
| 머리글 | wwan.h(Wwan.h 포함) |