struktur WWAN_PROVIDER (wwan.h)
Struktur WWAN_PROVIDER mewakili detail tentang penyedia jaringan.
typedef struct _WWAN_PROVIDER {
WCHAR ProviderId[WWAN_PROVIDERID_LEN];
ULONG ProviderState;
WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
ULONG WwanDataClass;
} WWAN_PROVIDER, *PWWAN_PROVIDER;
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 Metropolitan Statistical Areas (MSA) di Amerika Serikat. 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 | Arti |
---|---|
WWAN_PROVIDER_STATE_HOME | Penyedia jaringan adalah operator beranda. |
WWAN_PROVIDER_STATE_FORBIDDEN | Penyedia jaringan ada dalam daftar terlarang. |
WWAN_PROVIDER_STATE_PREFERRED | Penyedia jaringan ada di 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-nilai tersebut dan OID terkait.
Nilai | OID |
---|---|
WWAN_PROVIDER_STATE_HOME | |
WWAN_PROVIDER_STATE_FORBIDDEN WWAN_PROVIDER_STATE_PREFERRED |
|
WWAN_PROVIDER_STATE_VISIBLE WWAN_PROVIDER_STATE_REGISTERED WWAN_PROVIDER_STATE_HOME WWAN_PROVIDER_STATE_PREFERRED WWAN_PROVIDER_STATE_FORBIDDEN |
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 singkatan 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 WwanDataClass anggota WWAN_DEVICE_CAPS.
Anggota ini dapat diabaikan ketika dikueri untuk OID_WWAN_HOME_PROVIDER.
Syarat | Nilai |
---|---|
klien minimum yang didukung | Tersedia di Windows 7 dan versi Windows yang lebih baru. |
Header | wwan.h (termasuk Wwan.h) |