struktur WWAN_DEVICE_CAPS_EX_REV1 (wwan.h)
Penting
Komunikasi bebas bias
Microsoft mendukung lingkungan yang beragam dan inklusif. Artikel ini berisi referensi ke terminologi yang diakui panduan gaya Microsoft untuk komunikasi bebas bias sebagai pengecualian. Kata atau frasa digunakan dalam artikel ini untuk konsistensi karena saat ini muncul di perangkat lunak. Ketika perangkat lunak diperbarui untuk menghapus bahasa, artikel ini akan diperbarui agar selaras.
Struktur WWAN_DEVICE_CAPS_EX_REV1 mewakili kemampuan perangkat broadband seluler. WWAN_DEVICE_CAPS_EX_REV1 memperbarui struktur WWAN_DEVICE_CAPS_EX yang ada dengan menghapus bidang berikut:
- WwanSimClassBitMasks
- WwanWCDMABandClass
- WwanLTEBandClass
- WwanNRBandClass
- WwanMiscCaps
Sintaks
typedef struct _WWAN_DEVICE_CAPS_EX_REV1 {
WWAN_DEVICE_TYPE WwanDeviceType;
WWAN_CELLULAR_CLASS WwanCellularClass;
WWAN_VOICE_CLASS WwanVoiceClass;
WWAN_SIM_CLASS WwanSimClass;
ULONG WwanDataClass;
WCHAR CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN];
ULONG WwanGsmBandClass;
ULONG WwanCdmaBandClass;
WCHAR CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN];
ULONG WwanSmsCaps;
ULONG WwanControlCaps;
WCHAR DeviceId[WWAN_DEVICEID_LEN];
WCHAR Manufacturer[WWAN_MANUFACTURER_LEN];
WCHAR Model[WWAN_MODEL_LEN];
WCHAR FirmwareInfo[WWAN_FIRMWARE_LEN];
ULONG MaxActivatedContexts;
ULONG WwanAuthAlgoCaps;
ULONG ExecutorIndex;
ULONG WwanOptionalServiceCaps;
WWAN_LIST_HEADER CellularClassListHeader;
} WWAN_DEVICE_CAPS_EX_REV1, *PWWAN_DEVICE_CAPS_EX_REV1;
Anggota
WwanDeviceType
Jenis perangkat. Driver miniport harus mengatur jenis perangkat menjadi nilai selain WwanDeviceTypeUnknown.
WwanCellularClass
Kelas seluler perangkat. Driver miniport harus mengatur kelas seluler menjadi nilai selain WwanCellularClassUnknown. Nilai dalam fitur kontrol anggota ini khusus untuk teknologi seluler, seperti mode pendaftaran penyedia jaringan.
Driver miniport yang mendukung multi-mode harus mengatur ini ke WwanCellularClassGsm.
WwanVoiceClass
Kelas suara perangkat. Anggota ini memberi tahu Layanan MB tentang keberadaan layanan suara sirkuit, dan bagaimana layanan tersebut berinteraksi dengan layanan data. Ketahuilah bahwa Layanan MB tidak mendukung suara yang dialihkan sirkuit secara asli, juga tidak menghalanginya. Terserah driver miniport untuk menentukan cara mendukung suara sirkuit. Anggota WwanVoiceClass ini memungkinkan Layanan MB untuk mendukung fitur ini di masa mendatang.
WwanSimClass
Kelas Modul Identitas Pelanggan (kartu SIM). Driver miniport harus mengatur kelas SIM menjadi nilai selain WwanSimClassUnknown.
WwanDataClass
Bitmap yang mewakili kelas data yang didukung perangkat. Tabel berikut ini memperlihatkan kemungkinan nilai untuk anggota ini.
| Nilai | Makna |
|---|---|
| WWAN_DATA_CLASS_NONE | Perangkat tidak mendukung layanan data. |
| WWAN_DATA_CLASS_GPRS | Layanan data General Packet Radio Service (GPRS) didukung. Nilai ini hanya berlaku untuk perangkat berbasis GSM. |
| WWAN_DATA_CLASS_EDGE | Layanan data Data for Global Evolution (EDGE) yang disempurnakan didukung. Nilai ini hanya berlaku untuk perangkat berbasis GSM. |
| WWAN_DATA_CLASS_UMTS | Layanan data Universal Mobile Telecommunications System (UMTS) didukung. Nilai ini hanya berlaku untuk perangkat berbasis GSM. |
| WWAN_DATA_CLASS_HSDPA | High-Speed layanan data Downlink Packet Access (HSDPA) didukung. Nilai ini hanya berlaku untuk perangkat berbasis GSM. |
| WWAN_DATA_CLASS_HSUPA | High-Speed layanan data Uplink Packet Access (HSUPA) didukung. Nilai ini hanya berlaku untuk perangkat berbasis GSM. |
| WWAN_DATA_CLASS_LTE | Layanan data LTE didukung. Nilai ini hanya berlaku untuk perangkat berbasis GSM. |
| WWAN_DATA_CLASS_5G | Layanan data 5G didukung. |
| WWAN_DATA_CLASS_TDSCDMA | Layanan data CDMA Sinkron Divisi Waktu didukung. |
| WWAN_DATA_CLASS_1XRTT | CdMA 1x Radio Transmission Technology (1xRTT, juga dikenal sebagai cdma2000, CDMA2000 1x, dan sebagainya) layanan data didukung. Nilai ini hanya berlaku untuk perangkat berbasis CDMA. |
| WWAN_DATA_CLASS_1XEVDO | CDMA Evolution-Data Optimized (awalnya Data Only, 1xEDVO, juga dikenal sebagai layanan data CDMA2000 1x EV-DO, atau 1x EVDO) didukung. Nilai ini hanya berlaku untuk perangkat berbasis CDMA. |
| WWAN_DATA_CLASS_1XEVDO_REVA | Layanan data 1xEVDO RevA didukung. Nilai ini hanya berlaku untuk perangkat berbasis CDMA. |
| WWAN_DATA_CLASS_1XEVDV | Layanan data CDMA Evolution-Data/Voice (juga dikenal sebagai CDMA 2000 1x EV-DV, atau 1x EVDV) didukung. Nilai ini hanya berlaku untuk perangkat berbasis CDMA. |
| WWAN_DATA_CLASS_3XRTT | Layanan data CDMA 3x Radio Transmission Technology (3xRTT) didukung. Nilai ini hanya berlaku untuk perangkat berbasis CDMA. |
| WWAN_DATA_CLASS_1XEVDO_REVB | Layanan data 1xEVDO RevB didukung. Nilai ini hanya berlaku untuk perangkat berbasis CDMA. |
| WWAN_DATA_CLASS_UMB | Layanan data UMB didukung. Nilai ini hanya berlaku untuk perangkat berbasis CDMA. |
| WWAN_DATA_CLASS_CUSTOM | Perangkat mendukung layanan data yang tidak tercantum dalam tabel ini. |
CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN]
String yang dihentikan NULL yang mewakili nama kelas data kustom. Anggota ini hanya berlaku ketika driver miniport mengatur bit WWAN_DATA_CLASS_CUSTOM di anggota WwanDataClass .
WwanGsmBandClass
Bitmap yang mewakili pita frekuensi yang didukung perangkat berbasis GSM. Tabel berikut ini memperlihatkan kemungkinan nilai untuk anggota ini.
| Nilai | Makna |
|---|---|
| WWAN_BAND_CLASS_UNKNOWN | Pita frekuensi yang didukung oleh perangkat tidak diberikan. |
| WWAN_BAND_CLASS_I | Perangkat mendukung spektrum UMTS2100. |
| WWAN_BAND_CLASS_II | Perangkat mendukung spektrum UMTS1900. |
| WWAN_BAND_CLASS_III | Perangkat mendukung spektrum UMTS1800. |
| WWAN_BAND_CLASS_IV | Perangkat mendukung spektrum AWS. |
| WWAN_BAND_CLASS_V | Perangkat mendukung spektrum UMTS850. |
| WWAN_BAND_CLASS_VI | Perangkat mendukung spektrum UMTS800. |
| WWAN_BAND_CLASS_VII | Perangkat mendukung spektrum UMTS2600. |
| WWAN_BAND_CLASS_VIII | Perangkat mendukung spektrum UMTS900. |
| WWAN_BAND_CLASS_IX | Perangkat mendukung spektrum UMTS1700. |
| WWAN_BAND_CLASS_X | |
| WWAN_BAND_CLASS_CUSTOM | Perangkat mendukung spektrum selain yang tercantum dalam tabel ini. |
Jika driver miniport menentukan WWAN_BAND_CLASS_CUSTOM, driver miniport juga harus memberikan nama kelas data di CustomBandClass.
Untuk informasi selengkapnya tentang nilai-nilai ini, lihat OID_WWAN_DEVICE_CAPS.
WwanCdmaBandClass
Bitmap yang mewakili pita frekuensi yang didukung perangkat berbasis CDMA. Tabel berikut ini memperlihatkan nilai yang mungkin untuk anggota ini.
| Nilai | Makna |
|---|---|
| WWAN_BAND_CLASS_UNKNOWN | Pita frekuensi yang didukung oleh perangkat tidak diberikan. |
| WWAN_BAND_CLASS_0 | Perangkat ini mendukung band 800MHz. |
| WWAN_BAND_CLASS_I | Perangkat ini mendukung band 1900MHz. |
| WWAN_BAND_CLASS_II | Perangkat mendukung band TACS. |
| WWAN_BAND_CLASS_III | Perangkat mendukung pita JTACS. |
| WWAN_BAND_CLASS_IV | Perangkat ini mendukung band PCS Korea. |
| WWAN_BAND_CLASS_V | Perangkat ini mendukung band 450 MHz. |
| WWAN_BAND_CLASS_VI | Perangkat ini mendukung band 2 GHz. |
| WWAN_BAND_CLASS_VII | Perangkat ini mendukung band 700 MHz. |
| WWAN_BAND_CLASS_VIII | Perangkat ini mendukung band 1800 MHz. |
| WWAN_BAND_CLASS_IX | Perangkat ini mendukung band 900 MHz. |
| WWAN_BAND_CLASS_X | Perangkat ini mendukung band sekunder 800 MHz. |
| WWAN_BAND_CLASS_XI | Perangkat ini mendukung pita PAMR Eropa 400 MHz. |
| WWAN_BAND_CLASS_XII | Perangkat ini mendukung band PAMR 800 MHz. |
| WWAN_BAND_CLASS_XIII | Perangkat ini mendukung pita Ekstensi IMT2000 2,5GHz. |
| WWAN_BAND_CLASS_XIV | Perangkat ini mendukung band PCS 1.9GHz AS. |
| WWAN_BAND_CLASS_XV | Perangkat mendukung aws band. |
| WWAN_BAND_CLASS_XVI | Perangkat ini mendukung band US 2.5GHz. |
| WWAN_BAND_CLASS_XVII | Perangkat ini mendukung band Hanya Tautan Maju 2,5 GHz AS. |
| WWAN_BAND_CLASS_CUSTOM | Perangkat mendukung pita selain band yang tercantum dalam tabel ini. |
Jika driver miniport menentukan WWAN_BAND_CLASS_CUSTOM, driver miniport juga harus memberikan nama kelas data di CustomBandClass.
Untuk informasi selengkapnya tentang nilai-nilai ini, lihat OID_WWAN_DEVICE_CAPS.
CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN]
String yang dihentikan NULL yang mewakili nama kelas pita kustom. Anggota ini hanya berlaku ketika driver miniport mengatur bit WWAN_BAND_CLASS_CUSTOM baik di anggota WwanGsmBandClass atau WwanCdmaBandClass , sebagaimana merujuknya.
WwanSmsCaps
Bitmap yang mewakili jenis pesan SMS dan alur arah yang didukung perangkat. Tabel berikut ini memperlihatkan pengaturan kapabilitas SMS yang valid.
| Nilai | Makna |
|---|---|
| WWAN_SMS_CAPS_NONE | Perangkat tidak mendukung pesan SMS. |
| WWAN_SMS_CAPS_PDU_SEND | Untuk perangkat berbasis GSM, nilai ini berarti bahwa perangkat mendukung pengiriman pesan SMS bergaya PDU. Untuk perangkat berbasis CDMA, nilai ini berarti bahwa perangkat mampu mengirim pesan SMS dalam format biner seperti yang didefinisikan dalam bagian "3.4.2.1 SMS Point-to-Point Message" dalam spesifikasi 3GPP2 C.S0015-A "Short Message Service (SMS) untuk Wideband Spread Spectrum Systems". |
| WWAN_SMS_CAPS_PDU_RECEIVE | Untuk perangkat berbasis GSM, nilai ini berarti bahwa perangkat mendukung penerimaan pesan SMS bergaya PDU. Untuk perangkat berbasis CDMA, nilai ini berarti bahwa perangkat mampu membaca pesan SMS dalam format biner seperti yang didefinisikan dalam bagian "3.4.2.1 SMS Point-to-Point Message" dalam spesifikasi 3GPP2 C.S0015-A "Layanan Pesan Singkat (SMS) untuk Wideband Spread Spectrum Systems". |
| WWAN_SMS_CAPS_TEXT_SEND | Perangkat ini mendukung pengiriman pesan SMS gaya Teks. Bendera ini berlaku untuk perangkat berbasis CDMA. |
| WWAN_SMS_CAPS_TEXT_RECEIVE | Perangkat mendukung penerimaan pesan SMS gaya Teks. Bendera ini berlaku untuk perangkat berbasis CDMA. |
Driver Miniport harus mengatur anggota ini untuk mencerminkan dukungan hanya untuk format PDU GSM untuk menerima dan mengirim SMS ketika penyedia rumah saat ini mampu melakukan multi-mode. Oleh karena itu, jika driver miniport menerima SMS dalam format asli kelas seluler, misalnya CDMA TEXT atau CDMA PDU, maka driver miniport diperlukan untuk melakukan terjemahan ke GSM PDU dan menunjukkannya ke Layanan MB. Demikian pula jika driver miniport menerima permintaan kirim dalam format GSM PDU maka diperlukan untuk melakukan terjemahan ke format kelas seluler aslinya.
WwanControlCaps
Bitmap yang mewakili kemampuan kontrol yang didukung perangkat. Tabel berikut ini memperlihatkan pengaturan WwanControlCaps yang valid untuk perangkat berbasis GSM dan berbasis CDMA.
| Nilai | Makna |
|---|---|
| WWAN_CTRL_CAPS_REG_MANUAL | Menunjukkan apakah jaringan penyedia mengizinkan pemilihan jaringan manual. Driver miniport untuk perangkat berbasis GSM harus menentukan bendera ini. Driver miniport untuk perangkat berbasis CDMA tidak boleh menentukan bendera ini. |
| WWAN_CTRL_CAPS_HW_RADIO_SWITCH | Menunjukkan keberadaan sakelar daya radio perangkat keras. Ini sesuai dengan nilai WwanDeviceTypeEmbedded dari enumerasi WWAN_DEVICE_TYPE. |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IP | Menunjukkan bahwa perangkat berbasis CDMA dikonfigurasi untuk mendukung IP seluler. Bendera ini hanya berlaku untuk perangkat berbasis CDMA. Driver Miniport tidak boleh mengatur bendera ini ketika penyedia rumah saat ini mampu multi-mode. |
| WWAN_CTRL_CAPS_CDMA_SIMPLE_IP | Menunjukkan bahwa perangkat berbasis CDMA dikonfigurasi untuk dukungan IP sederhana. Bendera ini hanya berlaku untuk perangkat berbasis CDMA. Driver Miniport tidak boleh mengatur bendera ini ketika penyedia rumah saat ini mampu multi-mode. |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IP dikombinasikan dengan WWAN_CTRL_CAPS_CDMA_SIMPLE_IP | Menunjukkan bahwa perangkat berbasis CDMA dikonfigurasi untuk mendukung IP seluler, dengan IP sederhana sebagai opsi fallback. |
| WWAN_CTRL_CAPS_PROTECT_UNIQUEID | Menunjukkan bahwa Windows tidak boleh menampilkan Identitas Pelanggan Seluler Internasional (IMSI). |
| WWAN_CTRL_CAPS_USSD | Menunjukkan bahwa perangkat MB berbasis GSM dikonfigurasi untuk mendukung protokol USSD. Bendera ini hanya berlaku untuk perangkat berbasis GSM. Driver Miniport yang mendukung pengiriman dan penerimaan pesan USSD mengatur bendera ini. Driver Miniport dapat mengatur bendera ini ketika penyedia rumah berkemampuan multi-mode saat ini sisi GSM jaringan mendukung USSD bahkan jika sisi CDMA jaringan tidak mendukung USSD. |
| WWAN_CTRL_CAPS_MODEL_MULTI_CARRIER | Menunjukkan bahwa perangkat MB mendukung pendaftaran dan koneksi ke beberapa operator jaringan. |
| WWAN_CTRL_CAPS_MULTI_MODE | Bendera ini menunjukkan bahwa penyedia rumah saat ini mendukung beberapa kelas seluler/RAK (Teknologi Akses Radio). |
Driver miniport perangkat berbasis CDMA harus menentukan WWAN_CTRL_CAPS_CDMA_MOBILE_IP, atau WWAN_CTRL_CAPS_CDMA_SIMPLE_IP, atau kedua bendera untuk memberi tahu Layanan MB tentang jenis IP yang didukung perangkat.
DeviceId[WWAN_DEVICEID_LEN]
String yang dihentikan NULL yang mewakili ID perangkat.
Untuk perangkat berbasis GSM, string harus sesuai dengan format International Mobile Equipment Identity (IMEI) (hingga 15 digit).
Untuk perangkat berbasis CDMA, string harus sesuai dengan format Electronic Serial Number (ESN, 11 digit) dan Mobile Equipment Identifier (MEID, 17 digit).
Untuk driver miniport berkemampuan multi-mode, misalnya yang mengatur bendera WWAN_CTRL_CAPS_MULTI_MODE di WwanControlCaps, hanya DeviceId berbasis GSM yang harus dilaporkan.
Nilai ini harus disimpan dalam memori perangkat dan harus tersedia bahkan ketika perangkat MB/SIM memerlukan PIN untuk membuka kunci.
Manufacturer[WWAN_MANUFACTURER_LEN]
String yang dihentikan NULL yang mewakili produsen perangkat. Anggota ini bersifat opsional.
Model[WWAN_MODEL_LEN]
String yang dihentikan NULL yang mewakili model perangkat. Anggota ini bersifat opsional.
FirmwareInfo[WWAN_FIRMWARE_LEN]
String yang dihentikan NULL yang mewakili informasi spesifik firmware tentang perangkat. Anggota ini bersifat opsional.
MaxActivatedContexts
Jumlah maksimum konteks yang diaktifkan yang didukung oleh perangkat. Driver Miniport harus memberlakukan batas ini dengan gagal dalam upaya aktivasi apa pun yang melebihi MaxActivatedContexts.
WwanAuthAlgoCaps
Bitmap yang mewakili jenis metode autentikasi yang didukung perangkat MB.
| Nilai | Makna |
|---|---|
| WWAN_AUTH_ALGO_CAPS_NONE | Perangkat MB tidak mendukung metode autentikasi apa pun. |
| WWAN_AUTH_ALGO_CAPS_SIM | Perangkat MB mendukung metode autentikasi SIM. |
| WWAN_AUTH_ALGO_CAPS_AKA | Perangkat MB mendukung metode autentikasi AKA. |
| WWAN_AUTH_ALGO_CAPS_AKAP | Perangkat MB mendukung metode autentikasi AKA (AKA Prime). |
ExecutorIndex
Anggota WwanDeviceType untuk WWAN_DEVICE_CAPS_EX_REV1 tidak lagi mengacu pada perangkat modem melainkan ke pelaksana individu. Setiap perangkat adalah entitas pelaksana RF yang diketahui OS.
WwanOptionalServiceCaps
Struktur ULONG yang mewakili ekstensi layanan Microsoft yang didukung modem yang mendasar. Ini adalah struktur bitmap 64-bit yang bitnya tidak terdefinisi dicadangkan dan harus diatur ke "0." Saat ekstensi layanan baru diperkenalkan, bit yang dipesan akan digunakan untuk mewakili ekstensi layanan baru.
| Nilai | Mask | Makna | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| WWAN_OPTIONAL_SERVICE_CAPS_NONE | 0h | Perangkat dan driver tidak mendukung ekstensi layanan opsional. | |||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_LTE_ATTACH | 1h | Perangkat dan driver mendukung konfigurasi lampiran LTE dan MBIM CID berikut:
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_CONTEXT_MGMT | 2h | Perangkat dan driver mendukung os mengelola konteks yang disediakan modem dan MBIM CID berikut:
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_MULTI_SIM | 4 jam | Perangkat dan driver mendukung multi-SIM/multi-eksekutor dan OID berikut: | |||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_EX_SAR | 8h | Perangkat dan driver mendukung konfigurasi SAR dari OS dan MBIM CID berikut:
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_NETWORK_BLACKLIST | 16h | Konfigurasi dukungan perangkat dan driver dari daftar pengirim yang diblokir jaringan dari OS dan MBIM CID berikut:
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_5G_NSA | Perangkat dan driver mendukung semua ekstensi terkait 5G baru di Windows 10, versi 1903. Tabel berikut menunjukkan pesan NDIS dan revisinya yang harus didukung driver miniport jika bit ini diatur.
|
CellularClassListHeader
Objek WWAN_LIST_HEADER yang diformat yang mewakili daftar kelas seluler yang didukung perangkat berkemampuan multi-mode. Anggota ElementType di WWAN_LIST_HEADER harus selalu diatur ke WwanStructCellularClass. Anggota ElementCount di WWAN_LIST_HEADER diatur ke jumlah kelas seluler yang mengikuti struktur WWAN_LIST_HEADER. Perangkat MB yang tidak mampu multi-mode harus mengatur ElementCount ke 0.
Keterangan
Driver Miniport harus menentukan WWAN_DATA_CLASS_CUSTOM jika layanan data yang didukung oleh perangkat bukan milik nilai lain yang ditentukan dalam tabel untuk anggota WwanDataClass . Jika driver miniport mengatur bendera WWAN_DATA_CLASS_CUSTOM, driver miniport juga harus memberikan nama kelas data di anggota CustomDataClass .
Untuk perangkat berbasis GSM, hanya kelas data berbasis GSM yang harus ditentukan. Misalnya, GPRS, EDGE, UMTS, HSDPA, LTE, dan TD-SCDMA. Jika driver miniport Anda mendukung TD-SCDMA, maka harus menentukan WWAN_DATA_CLASS_CUSTOM di anggota WwanDataClass dan string "TD-SCDMA" di anggota CustomDataClass .
Untuk perangkat berbasis CDMA, hanya layanan data terkait CDMA yang harus ditentukan. Misalnya, 1xRTT, 1xEV-DO, 1xEV-DO RevA, dan UMB. 1xEV-DO RevB didefinisikan untuk digunakan di masa mendatang. 1xEV-DV dan 3xRTT juga didefinisikan untuk kelengkapan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 10, version 2004 |
| Header | wwan.h |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk