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 포함)

추가 정보

NDIS_WWAN_SET_CONTEXT_STATE

WWAN_ACTIVATION_COMMAND

WWAN_AUTH_PROTOCOL

WWAN_COMPRESSION