WWAN_CONTEXT_STATE 구조체(wwan.h)
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 멤버를 네트워크별 오류 코드로 설정해야 합니다.
NDIS_WWAN_SET_CONTEXT_STATE 대한 응답의 경우 이 멤버를 사용하여 네트워크에서 반환된 추가 오류 코드를 제공합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 이상 버전의 Windows에서 사용할 수 있습니다. |
| 머리글 | wwan.h(wwan.h 포함) |