WWAN_CONTEXT_STATE 구조체(wwan.h)

아티클
08/08/2023

WWAN_CONTEXT_STATE 구조는 MB 디바이스의 PDP(패킷 데이터 프로토콜) 컨텍스트 상태를 나타냅니다.

구문

typedef struct _WWAN_CONTEXT_STATE {
  ULONG                    uNwError;
  ULONG                    ConnectionId;
  WWAN_ACTIVATION_STATE    ActivationState;
  WWAN_VOICE_CALL_STATE    VoiceCallState;
  WWAN_IP_TYPE             IPType;
  WWAN_CONNECTION_MEDIA    ConnectionMedia;
  WCHAR                    AccessString[WWAN_ACCESSSTRING_LEN];
  WWAN_SINGLE_NSSAI        Snssai;
  ULONG                    FoundMatchingConnectionId;
  WWAN_OFFSET_SIZE_ELEMENT TrafficParameters;
} WWAN_CONTEXT_STATE, *PWWAN_CONTEXT_STATE;

멤버

uNwError

네트워크 관련 오류입니다. 다음 표에서는 3GPP TS 24.008 사양에 설명된 연결 실패 값을 보여 줍니다.

3GPP 24.008 원인 코드	원인 코드 해석
8 - 연산자 확인 금지	패킷 데이터 서비스는 연산자에 의해 차단됩니다.
26 - 리소스 부족	네트워크에서 리소스가 부족하여 컨텍스트를 활성화할 수 없습니다.
27 - APN(누락되거나 알 수 없는 액세스 지점 이름)	활성화 요청에 APN 또는 알 수 없는 APN이 제공되지 않습니다.
29, 30, 31 - 사용자 인증 실패	정품 인증 요청에 잘못된 사용자 이름 또는 암호가 제공되었습니다.
32 - 서비스 옵션이 지원되지 않음	GPRS는 네트워크에서 지원되지 않습니다.
33 - 요청된 서비스 옵션이 구독되지 않음	요청된 서비스(GPRS)는 사용자가 구독하지 않습니다.
34 - 서비스 옵션이 일시적으로 순서가 잘못되었습니다.	패킷 데이터 서비스가 일시적으로 순서가 잘못되었습니다. 사용자는 나중에 다시 시도해야 합니다.
43 - 알 수 없는 PDP(패킷 데이터 프로토콜) 컨텍스트	활성화 요청에 APN 또는 알 수 없는 APN이 제공되지 않습니다.

ConnectionId

MB 서비스는 OID_WWAN_CONNECT 사용하여 연결 요청 시 이 멤버의 값을 지정합니다. 미니포트 드라이버는 이 값을 복사하여 후속 연결 상태 변경에 대해 MB 서비스에 알릴 때 사용해야 합니다.

ActivationState

디바이스의 현재 활성화 상태입니다.

VoiceCallState

디바이스의 현재 음성 통화 상태입니다.

IPType

IP 유형을 지정하는 WWAN_IP_TYPE 열거형의 값입니다.

ConnectionMedia

설정된 컨텍스트/세션에 대한 미디어 형식입니다.

AccessString[WWAN_ACCESSSTRING_LEN]

설정된 컨텍스트/세션에 대해 선택한 APN/DNN입니다.

Snssai

단일 NSSAI(네트워크 조각 선택 지원 정보)를 나타내는 WWAN_SINGLE_NSSAI 구조체입니다.

FoundMatchingConnectionId

상태 WWAN_STATUS_SESSION_ALREADY_EXISTS 경우에만 유효합니다.

TrafficParameters

WWAN_OFFSET_SIZE_ELEMENT 구조체입니다. 상태 WWAN_STATUS_DESSOCIATION_NEEDED_FOR_APPLICATION 경우에만 유효합니다. 처음 4바이트는 WWAN_SET_CONTEXT_STATE 처음부터 계산된 MBIM_TLV_TYPE_TRAFFIC_PARAMETERS 원시 데이터를 포함하는 DataBuffer에 대한 오프셋(바이트)입니다. 두 번째 4바이트는 MBIM_TLV_TYPE_TRAFFIC_PARAMETERS 원시 데이터의 크기(바이트)입니다.

설명

설정 OID 요청 및 원치 않는 상태 이벤트는 uNwError 멤버를 사용합니다. 네트워크별 오류가 없거나 네트워크 관련 오류를 알 수 없는 경우 미니포트 드라이버는 이 멤버를 0으로 설정해야 합니다.

다음 점은 다양한 시나리오에서 네트워크별 오류를 반환하는 지침을 제공합니다.

설정된 요청이 실패하면 미니포트 드라이버는 네트워크별 오류 코드를 반환해야 합니다. 이 경우 미니포트 드라이버는 NDIS_WWAN_CONTEXT_STATE 구조체의 uStatus 멤버를 WWAN_STATUS_FAILURE 설정하거나 WWAN_STAUS_INVALID_ACCESS_STRING 또는 WWAN_STATUS_INVALID_USER_NAME_PWD 같은 보다 구체적인 오류를 설정하고 uNwError 멤버를 네트워크별 오류 코드로 설정해야 합니다.
네트워크 시작 컨텍스트 비활성화로 인해 디바이스 컨텍스트 활성화 상태가 변경될 때마다 원치 않는 상태 이벤트에 네트워크별 오류가 포함되어야 합니다. 이 경우 미니포트 드라이버는 NDIS_WWAN_CONTEXT_STATE 구조체의 uStatus 멤버를 WWAN_STATUS_SUCCESS 설정하고 uNwError 멤버를 네트워크별 오류 코드로 설정해야 합니다.

미니포트 드라이버는 네트워크에서 반환되는 컨텍스트 활성화 오류 코드의 GSM 표준 사양에 정의된 추가 오류 코드를 제공할 수 있습니다. 예를 들어 미니포트 드라이버는 uNwError 멤버를 통해 오류 코드 8(운영자 결정 금지)과 같은 3GPP 사양 TS 24.008 컨텍스트 활성화 오류 코드를 MB 서비스에 전달할 수 있습니다. CDMA 기반 네트워크별 오류 코드에 사용할 수 있는 표준은 없습니다. CDMA 기반 디바이스 및 네트워크는 uNwError 멤버를 사용하여 네트워크별 오류 코드 정보를 반환할 수 있습니다.

NDIS_WWAN_SET_CONTEXT_STATE 대한 응답의 경우 이 멤버를 사용하여 네트워크에서 반환된 추가 오류 코드를 제공합니다.