WWAN_PACKET_SERVICE 구조체(wwan.h)

  • 아티클

WWAN_PACKET_SERVICE 구조는 MB 디바이스의 패킷 서비스 첨부 파일 상태를 나타냅니다.

구문

typedef struct _WWAN_PACKET_SERVICE {
  ULONG                     uNwError;
  WWAN_PACKET_SERVICE_STATE PacketServiceState;
  ULONG                     AvailableDataClass;
  ULONG                     CurrentDataClass;
  WWAN_5G_FREQUENCY_RANGE   FrequencyRange;
  ULONG                     CurrentDataSubClass;
  WWAN_SINGLE_TAI           CurrentTai;
  ULONG                     Rel3GppVer;
} WWAN_PACKET_SERVICE, *PWWAN_PACKET_SERVICE;

멤버

uNwError

패킷 연결 또는 패킷 분리 실패의 경우 네트워크별 오류입니다. 이 멤버에 대한 자세한 내용은 다음 "설명" 섹션을 참조하세요.

PacketServiceState

디바이스의 패킷 서비스 상태입니다.

AvailableDataClass

현재 네트워크의 디바이스에서 사용할 수 있는 데이터 클래스를 나타내는 비트맵입니다. 자세한 값 목록은 WWAN_DEVICE_CAPSWwanDataClass 멤버를 참조하세요.

미니포트 드라이버는 디바이스가 네트워크에 등록되지 않았거나 데이터 클래스가 없거나 지원되는 데이터 클래스를 사용할 수 없는 경우 이 멤버를 WWAN_DATA_CLASS_NONE 설정해야 합니다. 미니포트 드라이버는 디바이스가 네트워크에 등록될 때 이 멤버를 유효한 값으로 설정해야 합니다.

CurrentDataClass

디바이스에서 현재 사용 중인 데이터 클래스를 나타내는 WWAN_DEVICE_CAPSWwanDataClass 멤버의 단일 값입니다.

HSPA를 제외한 모든 데이터 서비스의 경우 미니포트 드라이버는 이 멤버를 단일 WWAN_DATA_CLASS_XXX 값으로 설정해야 합니다. HSPA 데이터 서비스의 경우 미니포트 드라이버는 WWAN_DATA_CLASS_HSDPA 및 WWAN_DATA_CLASS_HSUPA 비트 단위 OR를 지정해야 합니다.

미니포트 드라이버는 이 멤버를 유효한 값으로 설정하고 디바이스가 서비스를 변경할 때(예: 1xRTT에서 1xEV-DO로) 적절한 알림을 보내야 합니다.

데이터 클래스가 WWAN_DEVICE_CAPS WwanDataClass 멤버에 미리 정의된 값 중 하나가 아닌 경우 미니포트 드라이버는 이 멤버를 WWAN_DATA_CLASS_CUSTOM 설정해야 합니다.

FrequencyRange

디바이스에서 사용 중인 빈도 범위를 지정하는 WWAN_5G_FREQUENCY_RANGE 값입니다. 이 멤버는 CurrentDataClass가 WWAN_DATA_CLASS_5G_NSA 또는WWAN_DATA_CLASS_SA 경우에만 유효합니다.

CurrentDataSubClass

이 필드는 NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3 경우에만 사용됩니다.

CurrentTai

현재 TAI(단일 추적 영역 ID)를 나타내는 WWAN_SINGLE_TAI 구조체입니다. 이 필드는 NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3 경우에만 사용됩니다.

Rel3GppVer

알 수 없는 경우 0xFFFFFFFF 사용됩니다. 알 수 없음은 MBIM_TLV_TYPE_3GPP_REL_VERSION MBIM_PACKET_SERVICE_INFO_V3 포함되어 있지 않거나, 디바이스가 0xFFFFFFFF 직접 반환하거나, 디바이스가 MBIM 3.0 이상을 사용하고 있다는 것을 의미합니다.

설명

현재 패킷 연결 서비스 상태는 일반적으로 디바이스의 사용자 인터페이스에 반영됩니다.

MB 서비스는 AvailableDataClass 에 표시되는 데이터 클래스를 디바이스의 기능과 함께 보고되는 지원되는 데이터 클래스와 결합하여 사용자에게 사용 가능한 선택 항목의 교집합을 표시합니다.

디바이스가 WWAN_DEVICE_CAPSWwanDataClass 멤버에서 미리 정의된 값 이외의 데이터 클래스도 지원하는 경우 미니포트 드라이버는 이 멤버의 데이터 클래스에 대해 정의된 적절한 비트 마스크와 함께 WWAN_DATA_CLASS_CUSTOM 플래그를 설정해야 합니다.

OID 요청뿐만 아니라 원치 않는 상태 이벤트 쿼리 및 설정은 uNwError 멤버를 사용합니다. 네트워크별 오류가 없거나 네트워크 관련 오류를 알 수 없는 경우 미니포트 드라이버는 이 멤버를 0으로 설정해야 합니다. MB 운영 의미 체계의 "상태 표시 구조" 섹션에는 3GPP TS 24.008 사양에 정의된 패킷 연결 또는 패킷 분리 원인 코드 오류 값이 표시됩니다.

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

  • 네트워크별 오류로 인해 패킷 연결 작업이 실패하는 경우 미니포트 드라이버는 쿼리 요청에 대한 응답으로 네트워크별 오류를 반환해야 합니다. 이 경우 미니포트 드라이버는 NDIS_WWAN_PACKET_SERVICE_STATE 구조체의 uStatus 멤버를 WWAN_STATUS_SUCCESS 설정하고 uNwError 멤버를 네트워크별 오류 코드로 설정해야 합니다.
  • 설정된 요청이 실패하면 미니포트 드라이버는 네트워크별 오류 코드를 반환해야 합니다. 이 경우 미니포트 드라이버는 NDIS_WWAN_PACKET_SERVICE_STATE 구조체의 uStatus 멤버를 WWAN_STATUS_FAILURE 설정하고 uNwError 멤버를 네트워크별 오류 코드로 설정해야 합니다.
  • 네트워크 패킷이 디바이스를 분리하기 때문에 디바이스 등록 상태가 변경될 때마다 원치 않는 상태 이벤트에 네트워크별 오류가 포함되어야 합니다. 이 경우 미니포트 드라이버는 NDIS_WWAN_PACKET_SERVICE_STATE 구조체의 uStatus 멤버를 WWAN_STATUS_SUCCESS 설정하고 uNwError 멤버를 네트워크별 오류 코드로 설정해야 합니다.
미니포트 드라이버는 네트워크에서 반환된 패킷 연결 오류 코드의 GSM 표준 사양에 정의된 추가 오류 코드를 제공할 수 있습니다. 예를 들어 미니포트 드라이버는 uNwError 멤버를 통해 오류 코드 12(위치 영역이 허용되지 않음)와 같은 3GPP 사양 TS 24.008 패킷 연결 오류 코드를 MB 서비스에 전달할 수 있습니다.

미니포트 드라이버는 가능한 한 빨리 instance 원인 코드를 보고해야 합니다. 예를 들어 네트워크 공급자에 디바이스를 등록하려고 할 때 MB 디바이스가 이러한 코드 중 하나를 발견하면 미니포트 드라이버가 해당 시간에 보고해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 및 이후 버전의 Windows에서 사용할 수 있습니다.
머리글 wwan.h(wwan.h 포함)

추가 정보

NDIS_WWAN_PACKET_SERVICE_STATE

WWAN_PACKET_SERVICE_STATE