struktur WWAN_PACKET_SERVICE (wwan.h)

Struktur WWAN_PACKET_SERVICE mewakili status lampiran layanan paket perangkat 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

Kesalahan khusus jaringan, jika terjadi kegagalan packet-attach atau packet-detach. Untuk informasi selengkapnya tentang anggota ini, lihat bagian "Komentar" 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 WwanDataClass anggota 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 terdaftar 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 WWAN_DATA_CLASS_HSDPA dan WWAN_DATA_CLASS_HSUPA yang sedikit bijaksana.

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 dalam WwanDataClass anggota WWAN_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_ yang mewakili Satu Identitas Area Pelacakan () 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.

Status layanan lampiran paket 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 apa pun selain nilai yang telah ditentukan sebelumnya dalam WwanDataClass anggota WWAN_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 mengatur 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 khusus jaringan dalam skenario yang berbeda:

• Jika operasi lampiran paket gagal karena kesalahan khusus jaringan, driver miniport harus mengembalikan kesalahan khusus jaringan sebagai respons terhadap kueri permintaan. Dalam hal ini, driver miniport harus mengatur uStatus anggota struktur NDIS_WWAN_PACKET_SERVICE_STATE ke WWAN_STATUS_SUCCESS dan mengatur uNwError anggota 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 uStatus anggota struktur NDIS_WWAN_PACKET_SERVICE_STATE ke WWAN_STATUS_FAILURE dan mengatur uNwError anggota ke kode kesalahan khusus jaringan.
• Setiap kali status pendaftaran perangkat berubah karena paket jaringan mencopot perangkat, maka peristiwa status yang tidak diminta harus menyertakan kesalahan spesifik jaringan. Dalam hal ini, driver miniport harus mengatur uStatus anggota struktur NDIS_WWAN_PACKET_SERVICE_STATE ke WWAN_STATUS_SUCCESS dan mengatur uNwError anggota 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 uNwError anggota.

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.

NDIS_WWAN_PACKET_SERVICE_STATE

WWAN_PACKET_SERVICE_STATE