struktur WWAN_PACKET_SERVICE (wwan.h)

Artikel
03/05/2024

Struktur WWAN_PACKET_SERVICE mewakili status lampiran layanan paket perangkat MB.

Sintaks

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;

Anggota

uNwError

Kesalahan khusus jaringan, jika terjadi kegagalan packet-attach atau packet-detach. Untuk informasi selengkapnya tentang anggota ini, lihat bagian "Keterangan" berikut ini.

PacketServiceState

Status layanan paket perangkat.

AvailableDataClass

Bitmap yang mewakili kelas data mana yang tersedia untuk perangkat di jaringan saat ini. Untuk daftar nilai terperinci, lihat anggota WwanDataClassdari WWAN_DEVICE_CAPS.

Driver miniport harus mengatur anggota ini ke WWAN_DATA_CLASS_NONE ketika perangkat tidak terdaftar ke jaringan, atau ketika tidak ada kelas data, atau ketika kelas data yang didukung tidak tersedia. Driver miniport harus mengatur anggota ini dengan nilai yang valid ketika perangkat didaftarkan ke jaringan.

CurrentDataClass

Satu nilai dari anggota WwanDataClass di WWAN_DEVICE_CAPS yang mewakili kelas data mana yang saat ini digunakan oleh perangkat.

Untuk semua layanan data, kecuali HSPA, driver miniport harus mengatur anggota ini ke satu nilai WWAN_DATA_CLASS_XXX. Untuk layanan data HSPA, driver miniport harus menentukan OR yang sedikit bijaksana dari WWAN_DATA_CLASS_HSDPA dan WWAN_DATA_CLASS_HSUPA.

Driver Miniport harus mengatur anggota ini dengan nilai yang valid dan mengirim pemberitahuan yang sesuai ketika perangkat mengubah layanan, misalnya, dari 1xRTT ke 1xEV-DO.

Driver miniport harus mengatur anggota ini ke WWAN_DATA_CLASS_CUSTOM jika kelas data bukan salah satu nilai yang telah ditentukan sebelumnya di anggota WwanDataClassWWAN_DEVICE_CAPS.

FrequencyRange

Nilai WWAN_5G_FREQUENCY_RANGE yang menentukan rentang frekuensi yang digunakan perangkat. Anggota ini hanya valid jika CurrentDataClassWWAN_DATA_CLASS_5G_NSA atau WWAN_DATA_CLASS_SA.

CurrentDataSubClass

Bidang ini hanya digunakan untuk NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.

CurrentTai

Struktur WWAN_SINGLE_TAI yang mewakili Identitas Area Pelacakan tunggal (TAI) saat ini. Bidang ini hanya digunakan untuk NDIS_WWAN_PACKET_SERVICE_STATE_REVISION_3.

Rel3GppVer

0xFFFFFFFF akan digunakan jika tidak diketahui. Tidak diketahui berarti MBIM_TLV_TYPE_3GPP_REL_VERSION tidak terkandung dalam MBIM_PACKET_SERVICE_INFO_V3, perangkat langsung mengembalikan 0xFFFFFFFF, atau perangkat menggunakan MBIM 3.0 atau yang lebih lama.

Keterangan

Status layanan packet-attach saat ini biasanya tercermin dalam antarmuka pengguna perangkat.

Layanan MB menggabungkan kelas data yang diwakili dalam AvailableDataClass dengan kelas data yang didukung yang dilaporkan dengan kemampuan perangkat untuk menampilkan persimpangan pilihan yang tersedia kepada pengguna.

Jika perangkat juga mendukung kelas data yang merupakan apa pun selain nilai yang telah ditentukan sebelumnya di anggota WwanDataClassWWAN_DEVICE_CAPS, driver miniport harus mengatur bendera WWAN_DATA_CLASS_CUSTOM bersama dengan bitmask yang sesuai yang ditentukan untuk kelas data dalam anggota ini.

Kueri dan atur 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 nol. Bagian "Struktur Indikasi Status" di MB Operational Semantics menunjukkan packet-attach atau packet-detach menyebabkan nilai kegagalan kode yang ditentukan dalam Spesifikasi 3GPP TS 24.008.

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

Jika operasi pelampiran paket gagal karena kesalahan khusus jaringan, driver miniport harus mengembalikan kesalahan khusus jaringan sebagai respons terhadap permintaan kueri . Dalam hal ini, driver miniport harus mengatur anggota uStatus dari struktur NDIS_WWAN_PACKET_SERVICE_STATE ke WWAN_STATUS_SUCCESS dan mengatur anggota uNwError ke kode kesalahan khusus jaringan.
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_PACKET_SERVICE_STATE ke WWAN_STATUS_FAILURE dan mengatur anggota uNwError ke kode kesalahan khusus jaringan.
Setiap kali status pendaftaran perangkat berubah karena paket jaringan mencopot perangkat, peristiwa status yang tidak diminta harus menyertakan kesalahan spesifik jaringan. Dalam hal ini, driver miniport harus mengatur anggota uStatus dari struktur NDIS_WWAN_PACKET_SERVICE_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 packet-attach yang dikembalikan oleh jaringan. Misalnya, driver miniport dapat mengomunikasikan spesifikasi 3GPP kode kesalahan TS 24.008 packet-attach, seperti kode kesalahan 12 (Area lokasi tidak diizinkan), ke Layanan MB melalui anggota uNwError .

Driver miniport harus melaporkan kode penyebab pada instans paling awal yang mungkin. Misalnya, jika perangkat MB menemukan salah satu kode ini saat mencoba mendaftarkan perangkat dengan penyedia jaringan, driver miniport harus melaporkannya pada saat itu.

Persyaratan

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

Lihat juga

NDIS_WWAN_PACKET_SERVICE_STATE

WWAN_PACKET_SERVICE_STATE

Share via