IOCTL_GNSS_LISTEN_NI IOCTL (gnssdriver.h)

Artikel
08/07/2023

Kode kontrol IOCTL_GNSS_LISTEN_NI digunakan untuk mulai mendengarkan permintaan SUPL NI.

IOCTL ini secara efektif menyediakan driver GNSS dengan permintaan I/O yang tertunda yang dapat digunakannya, melalui struktur yang tumpang tindih anggota GnssEvent, menyampaikan permintaan NI ke adaptor. Anggota GnssEvent adalah struktur GNSS_EVENT . Adaptor memastikan bahwa permintaan ini selalu tertunda dan akan mengeluarkan permintaan baru segera setelah permintaan yang tertunda diselesaikan. Ketika permintaan I/O diselesaikan, adaptor akan mengeluarkan IOCTL_GNSS_RESPOND_NI yang sesuai.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Atur ke NULL.

Panjang buffer input

Atur ke 0.

Buffer output

Atur ke NULL.

Panjang buffer output

Atur ke 0.

Blok status

Irp->IoStatus.Status diatur ke STATUS_SUCCESS jika permintaan berhasil. Jika tidak, Status ke kondisi kesalahan yang sesuai sebagai kode NTSTATUS .

Keterangan

EventType harus diatur ke GNSS_Event_NI dan anggota NiRequest yang diisi.

Catatan adaptor GNSS

Adaptor GNSS memastikan bahwa permintaan ini selalu tertunda, sehingga driver dapat menunjukkan ada permintaan NI.

Ketika driver menyelesaikan panggilan I/O, adaptor mengeluarkan IOCTL lain untuk terus menunggu permintaan NI lebih lanjut. Adaptor harus segera mengeluarkan IOCTL, bahkan jika permintaan NI sebelumnya ditahan karena interaksi pengguna.

Catatan driver GNSS

Setiap kali driver GNSS mendapatkan permintaan NI dari SUPL/CP, driver tersebut menyelesaikan operasi I/O.

Sertifikat ini, yang ditentukan oleh operator seluler dan dikonfigurasi melalui penyedia layanan konfigurasi SUPL, diperlukan untuk membangun koneksi dengan H-SLP atau E-SLP. Adaptor GNSS hanya mendorong konfigurasi SUPL, termasuk yang disertifikasi, ke driver GNSS. Ini tidak menginstal sertifikat dalam sistem file Windows. Ini karena IHV yang berbeda mungkin memiliki implementasi klien SUPL yang berbeda, dan beberapa mungkin termasuk implementasi tumpukan TLS mereka sendiri. Adaptor GNSS bersifat agnostik untuk setiap detail implementasi klien SUPL. Driver GNSS dapat menyimpan sertifikat dalam registri atau disk atau mendorongnya langsung ke klien SUPL berdasarkan penggunaannya. Klien SUPL harus mengurus penginstalan/penggunaan sertifikat sesuai kebutuhan.