OID_WWAN_CONNECT

OID_WWAN_CONNECT mengaktifkan atau menonaktifkan konteks paket tertentu dan membaca status aktivasi konteks.

Driver Miniport harus memproses permintaan set dan kueri secara asinkron, awalnya mengembalikan NDIS_STATUS_INDICATION_REQUIRED ke permintaan asli, dan kemudian mengirim pemberitahuan status NDIS_STATUS_WWAN_CONTEXT_STATE yang berisi struktur NDIS_WWAN_CONTEXT_STATE yang menunjukkan status konteks Packet Data Protocol (PDP) dari perangkat MB terlepas dari permintaan set atau kueri yang selesai.

Pemanggil yang meminta untuk mengatur status konteks Packet Data Protocol (PDP) dari perangkat MB memberikan struktur NDIS_WWAN_SET_CONTEXT_STATE ke driver miniport dengan informasi yang sesuai.

Keterangan

Untuk informasi selengkapnya tentang menggunakan OID ini, lihat Manajemen Konteks Paket WWAN.

Objek ini mengaktifkan atau menonaktifkan konteks paket tertentu dan membaca status aktivasi konteks. Driver miniport harus mengirim pemberitahuan peristiwa yang sesuai setiap kali status aktivasi berubah.

Objek ini dipanggil hanya jika driver miniport berada dalam status register WwanRegisterStateHome, WwanRegisterStatePartner, atau WwanRegisterStateRoaming. Ketika layanan paket aktif, perangkat juga harus dalam status lampiran WwanPacketServiceStateAttached.

Operasi set dan kueri didukung untuk objek ini.

• Pemrosesan permintaan yang ditetapkan memerlukan akses jaringan tetapi bukan akses SIM.

• Pemrosesan permintaan kueri tidak memerlukan akses ke jaringan atau SIM.

Struktur data untuk OID ini NDIS_WWAN_SET_CONTEXT_STATE. Driver miniport mengeluarkan indikasi status NDIS_STATUS_WWAN_CONTEXT_STATE untuk permintaan set dan kueri.

Dalam versi model driver ini, driver miniport hanya mencoba aktivasi konteks seperti yang diinstruksikan oleh Layanan MB. (Driver Miniport dapat mengaktifkan konteks yang dimulai oleh jaringan di versi yang lebih baru.) Driver Miniport tidak boleh mengaktifkan konteks secara otomatis bahkan setelah kehilangan pendaftaran atau sinyal. Jika string akses tidak disediakan dalam permintaan aktivasi, driver miniport tidak boleh mencoba memberikan string default. Sebaliknya, ini harus dilanjutkan dengan mengaktifkan konteks dengan string akses kosong.

Di sisi lain, driver miniport dapat menonaktifkan konteks seperti yang diinstruksikan oleh layanan MB. Ini dapat terjadi ketika konektivitas jaringan telah hilang selama periode yang melebihi ambang batas hilangnya sinyal sementara, atau sebagai bagian dari pematian atau pembersihan status dengan baik.

Karena hanya satu konteks yang diaktifkan yang didukung dalam versi ini, mengaktifkan atau menonaktifkan jumlah konteks tertentu untuk menyiapkan atau merobohkan koneksi layer-2 MB.

Pada permintaan yang ditetapkan, layanan MB melengkapi parameter ConnectionId dan ActivationCommand dalam struktur data WWAN_CONTEXT_STATE. Ini menginstruksikan driver miniport untuk mengaktifkan atau menonaktifkan konteks paket yang diidentifikasi oleh ConnectionId, berdasarkan nilai parameter ActivationCommandCommandActivate atau WwanActivationCommandDeactivate.

• Jika layanan atau langganan memerlukan aktivasi, driver miniport harus mengembalikan kode kesalahan WWAN_STATUS_SERVICE_NOT_ACTIVATED. Aktivasi PDP mungkin tidak terjadi sampai layanan atau langganan diaktifkan. Semua layanan darurat mungkin tersedia tergantung pada dukungan dari perangkat dan operator. Sistem operasi mungkin memanggil OID_WWAN_SERVICE_ACTIVATION sebagai respons terhadap kode kesalahan ini.

• Jika driver miniport menerima permintaan aktivasi konteks saat konteks paket lain saat ini diaktifkan, driver tersebut mengembalikan kode kesalahan WWAN_STATUS_MAX_ACTIVATED_CONTEXTS.

• Jika driver miniport menerima permintaan penonaktifan konteks tetapi konteks yang diidentifikasi oleh ConnectionId saat ini tidak diaktifkan, driver tersebut mengembalikan kode kesalahan WWAN_STATUS_CONTEXT_NOT_ACTIVATED.

Driver miniport menggunakan logika berikut untuk menentukan validitas pengaturan AccessString, UserName, dan Password dari permintaan yang ditetapkan:

• Jika ActivationCommand adalah WwanActivationCommandDeactivate, driver miniport harus mengabaikan pengaturan ketiga parameter ini. Sisa kasus hanya mempertimbangkan kasus ketika ActivationCommand adalah WwanActivationCommandActivate.

Aktivasi konteks berlanjut di seluruh masuk dan keluar pengguna. Ini bukan per pengguna masuk.

Pada permintaan kueri, Layanan MB menggunakan objek ini untuk mengetahui status aktivasi.

Untuk respons terhadap permintaan kueri, driver miniport mengirimkan pemberitahuan NDIS_STATUS_WWAN_CONTEXT_STATE.

Penting Catatan:

Dalam keadaan yang jarang terjadi, tetapi spesifik, Layanan MB pada Windows 7 dapat mencoba untuk terhubung secara otomatis sebelum konektivitas ke Internet telah ditentukan untuk koneksi yang sudah ada sebelumnya atau selama gangguan sesaat dalam konektivitas Internet dari koneksi yang sudah ada sebelumnya. Hal ini dapat mengakibatkan koneksi MB dan WLAN/Ethernet secara bersamaan. Misalnya, ini dapat terjadi selama boot sistem ketika MB dan koneksi lain dicoba secara bersamaan dan layanan Network List Manager masih mencoba menentukan konektivitas Internet koneksi lain menggunakan metode aktif dan pasif. Ini juga bisa terjadi karena pemadaman sementara dalam infrastruktur jaringan seperti server proksi perusahaan atau jaringan ISP. Dengan demikian, Layanan MB dapat mencoba untuk terhubung secara otomatis ke internet terlepas dari apakah opsi "Sambungkan otomatis hanya jika tidak ada koneksi Internet alternatif yang tersedia" dipilih.

Persyaratan

Versi	Tersedia di Windows 7 dan versi Windows yang lebih baru.
Header	Ntddndis.h (termasuk Ndis.h)

Lihat juga

Manajemen Konteks Paket WWAN