struktur WWAN_PROVIDER (wwan.h)

Artikel
08/08/2023

Struktur WWAN_PROVIDER mewakili detail tentang penyedia jaringan.

Sintaks

typedef struct _WWAN_PROVIDER {
  WCHAR ProviderId[WWAN_PROVIDERID_LEN];
  ULONG ProviderState;
  WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
  ULONG WwanDataClass;
} WWAN_PROVIDER, *PWWAN_PROVIDER;

Anggota

ProviderId[WWAN_PROVIDERID_LEN]

String numerik yang dihentikan NULL (0-9) yang mewakili identitas penyedia jaringan.

Untuk jaringan berbasis GSM, string ini adalah perangkaian Kode Negara Seluler (MCC) tiga digit dan Kode Jaringan Seluler (MNC) dua atau tiga digit. Operator berbasis GSM mungkin memiliki lebih dari satu MNC, dan karenanya lebih dari satu ProviderId .

Untuk jaringan berbasis CDMA, string ini adalah ID Sistem (SID) lima digit. Umumnya operator berbasis CDMA memiliki lebih dari satu SID. Biasanya, operator memiliki satu SID untuk setiap pasar, yang biasanya dibagi secara geografis dalam suatu negara berdasarkan peraturan, seperti Area Statistik Metropolitan (MSA) di Amerika Serikat Amerika. Driver miniport perangkat berbasis CDMA harus menentukan WWAN_CDMA_DEFAULT_PROVIDER_ID jika informasi ini tidak tersedia.

ProviderState

Nilai yang mewakili berbagai status yang dapat ditandai oleh entri penyedia jaringan. Tabel berikut ini memperlihatkan nilai yang mungkin harus ditentukan driver miniport (satu atau beberapa nilai dapat ditentukan).

Nilai	Makna
WWAN_PROVIDER_STATE_HOME	Penyedia jaringan adalah operator rumah.
WWAN_PROVIDER_STATE_FORBIDDEN	Penyedia jaringan ada dalam daftar terlarang.
WWAN_PROVIDER_STATE_PREFERRED	Penyedia jaringan ada dalam daftar pilihan.
WWAN_PROVIDER_STATE_VISIBLE	Penyedia jaringan terlihat.
WWAN_PROVIDER_STATE_REGISTERED	Penyedia jaringan saat ini didaftarkan oleh perangkat.
WWAN_PROVIDER_STATE_UNKNOWN	Status penyedia jaringan tidak diketahui.

Beberapa nilai dalam tabel sebelumnya hanya berlaku untuk pengidentifikasi objek tertentu (OID). Tabel berikut ini memperlihatkan asosiasi antara nilai tersebut dan OID terkait.

Nilai	OID
WWAN_PROVIDER_STATE_HOME	OID_WWAN_HOME_PROVIDER
WWAN_PROVIDER_STATE_FORBIDDEN WWAN_PROVIDER_STATE_PREFERRED	OID_WWAN_PREFERRED_PROVIDERS
WWAN_PROVIDER_STATE_VISIBLE WWAN_PROVIDER_STATE_REGISTERED WWAN_PROVIDER_STATE_HOME WWAN_PROVIDER_STATE_PREFERRED WWAN_PROVIDER_STATE_FORBIDDEN	OID_WWAN_VISIBLE_PROVIDERS

Nilai

OID

WWAN_PROVIDER_STATE_HOME

OID_WWAN_HOME_PROVIDER

WWAN_PROVIDER_STATE_FORBIDDEN

WWAN_PROVIDER_STATE_PREFERRED

OID_WWAN_PREFERRED_PROVIDERS

WWAN_PROVIDER_STATE_VISIBLE

WWAN_PROVIDER_STATE_REGISTERED

WWAN_PROVIDER_STATE_HOME

WWAN_PROVIDER_STATE_PREFERRED

WWAN_PROVIDER_STATE_FORBIDDEN

OID_WWAN_VISIBLE_PROVIDERS

ProviderName[WWAN_PROVIDERNAME_LEN]

String yang dihentikan NULL yang mewakili nama penyedia jaringan. Anggota ini terbatas pada, paling banyak, WWAN_PROVIDERNAME_LEN karakter.

Untuk jaringan berbasis GSM, jika Presentasi Pilihan Inisial Negara dan Nama Jaringan Seluler (PPCI&N) lebih panjang dari karakter WWAN_PROVIDERNAME_LEN, driver miniport harus menghubungkan nama jaringan.

Anggota ini diabaikan ketika Layanan MB menetapkan daftar penyedia pilihan.

Driver Miniport harus menentukan string NULL untuk perangkat yang tidak memiliki informasi ini.

WwanDataClass

Bitmap yang mewakili kelas data yang didukung perangkat. Untuk daftar nilai terperinci, lihat anggota WWAN_DEVICE_CAPS WwanDataClass.

Anggota ini dapat diabaikan ketika dikueri untuk OID_WWAN_HOME_PROVIDER.