struktur WWAN_CONTEXT_STATE (wwan.h)

Artikel
08/08/2023

Struktur WWAN_CONTEXT_STATE mewakili status konteks Packet Data Protocol (PDP) dari perangkat MB.

Sintaks

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;

Anggota

uNwError

Kesalahan khusus jaringan. Tabel berikut ini memperlihatkan nilai kegagalan koneksi seperti yang didokumenkan dalam Spesifikasi 3GPP TS 24.008.

3GPP 24.008 menyebabkan kode	Interpretasi kode penyebab
8 - Operator menentukan hambatan	Layanan data paket diblokir oleh operator.
26 - Sumber daya tidak mencukup	Konteks tidak dapat diaktifkan karena sumber daya pada jaringan tidak cukup.
27 - Nama Titik Akses (APN) yang hilang atau tidak diketahui	Tidak ada APN atau APN yang tidak diketahui yang disediakan dalam permintaan aktivasi.
29 , 30, 31 - Autentikasi pengguna gagal	Nama pengguna atau kata sandi yang disediakan dalam permintaan aktivasi salah.
32 - Opsi layanan tidak didukung	GPRS tidak didukung oleh jaringan.
33 - Opsi layanan yang diminta tidak berlangganan	Layanan yang diminta (GPRS) tidak berlangganan oleh pengguna.
34 - Opsi layanan untuk sementara tidak berurutan	Layanan data paket untuk sementara tidak berurutan. Pengguna harus mencoba lagi nanti.
43 - Konteks Protokol Data Paket (PDP) Tidak Diketahui	Tidak ada APN atau APN yang tidak diketahui yang disediakan dalam permintaan aktivasi.

ConnectionId

Layanan MB menentukan nilai untuk anggota ini pada saat permintaan sambungkan dengan menggunakan OID_WWAN_CONNECT. Driver Miniport harus menyalin nilai ini dan menggunakannya ketika mereka memberi tahu Layanan MB pada perubahan status koneksi berikutnya.

ActivationState

Status aktivasi perangkat saat ini.

VoiceCallState

Status panggilan suara perangkat saat ini.

IPType

Nilai dari enumerasi WWAN_IP_TYPE yang menentukan jenis IP.

ConnectionMedia

Jenis media untuk konteks/sesi yang ditetapkan.

AccessString[WWAN_ACCESSSTRING_LEN]

APN/DNN yang dipilih untuk konteks/sesi yang ditetapkan.

Snssai

Struktur WWAN_SINGLE_NSSAI yang mewakili satu Informasi Bantuan Pemilihan Iringan Jaringan (NSSAI).

FoundMatchingConnectionId

Hanya valid jika statusnya WWAN_STATUS_SESSION_ALREADY_EXISTS.

TrafficParameters

Struktur WWAN_OFFSET_SIZE_ELEMENT . Hanya valid jika statusnya WWAN_STATUS_DESSOCIATION_NEEDED_FOR_APPLICATION. 4 byte pertama adalah offset ke DataBuffer yang berisi data mentah MBIM_TLV_TYPE_TRAFFIC_PARAMETERS, dalam byte, dihitung dari awal WWAN_SET_CONTEXT_STATE. 4 byte kedua adalah ukuran data mentah MBIM_TLV_TYPE_TRAFFIC_PARAMETERS, dalam byte.

Keterangan

Set Permintaan OID serta peristiwa status yang tidak diminta menggunakan anggota uNwError . Jika tidak ada kesalahan khusus jaringan atau kesalahan spesifik jaringan tidak diketahui, driver miniport harus mengatur anggota ini ke 0.

Poin-poin berikut memberikan panduan tentang mengembalikan kesalahan spesifik jaringan dalam skenario yang berbeda:

Jika permintaan yang ditetapkan gagal, driver miniport harus mengembalikan kode kesalahan khusus jaringan. Dalam hal ini, driver miniport harus mengatur anggota uStatus dari struktur NDIS_WWAN_CONTEXT_STATE ke WWAN_STATUS_FAILURE, atau kesalahan yang lebih spesifik seperti WWAN_STAUS_INVALID_ACCESS_STRING atau WWAN_STATUS_INVALID_USER_NAME_PWD, dan mengatur anggota uNwError ke kode kesalahan khusus jaringan.
Setiap kali status aktivasi konteks perangkat berubah karena konteks yang dimulai jaringan dinonaktifkan, peristiwa status yang tidak diminta harus menyertakan kesalahan spesifik jaringan. Dalam hal ini, driver miniport harus mengatur anggota uStatus dari struktur NDIS_WWAN_CONTEXT_STATE ke WWAN_STATUS_SUCCESS, dan mengatur anggota uNwError ke kode kesalahan khusus jaringan.

Driver Miniport dapat memberikan kode kesalahan tambahan seperti yang didefinisikan oleh spesifikasi standar GSM dari kode kesalahan aktivasi konteks yang dikembalikan oleh jaringan. Misalnya, driver miniport dapat mengkomunikasikan spesifikasi 3GPP kode kesalahan aktivasi konteks TS 24.008, seperti kode kesalahan 8 (Operator menentukan barring), ke Layanan MB melalui anggota uNwError . Tidak ada standar yang tersedia untuk kode kesalahan khusus jaringan berbasis CDMA. Perangkat dan jaringan berbasis CDMA dapat mengembalikan informasi kode kesalahan khusus jaringan menggunakan anggota uNwError .

Jika terjadi respons terhadap NDIS_WWAN_SET_CONTEXT_STATE, gunakan anggota ini untuk memberikan kode kesalahan tambahan yang dikembalikan oleh jaringan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows versi Windows 8 dan yang lebih baru.
Header	wwan.h (sertakan Wwan.h)

Lihat juga

NDIS_WWAN_CONTEXT_STATE

WWAN_ACTIVATION_STATE

WWAN_VOICE_CALL_STATE

Share via