IOCTL_GNSS_DELETE_GEOFENCE IOCTL (gnssdriver.h)
Kode kontrol IOCTL_GNSS_DELETE_GEOFENCE digunakan oleh adaptor GNSS untuk menghapus geofence yang dibuat sebelumnya.
Berlaku untuk GNSS DDI versi 2 dan yang lebih baru.
Kode utama
Buffer input
Penunjuk ke struktur GNSS_GEOFENCE_DELETE_PARAM yang menentukan geofence yang akan dihapus.
Panjang buffer input
Atur ke sizeof(GNSS_GEOFENCE_DELETE_PARAM).
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
NTSTATUS dengan indikasi berikut:
STATUS_SUCCESS: Driver berhasil menghapus geofence.
STATUS_UNSUCCESSFUL: Gagal, geofence tidak dapat dihapus.
Catatan adaptor GNSS
Adaptor GNSS tidak mengharapkan panggilan ini gagal karena tidak ada cara elegan untuk menangani konsekuensi dari kegagalan ini. Jika gagal, adaptor GNSS akan mengeluarkan perintah GNSS_ResetGeofencesTracking dan menambahkan kembali geofence.
Catatan driver GNSS
Jika ini adalah geofence terakhir, driver GNSS harus menghentikan pelacakan geofence. Jika mesin GNSS tidak dapat melacak geofence (karena kondisi sinyal buruk atau kesalahan sementara lainnya) sebelum penghapusan geofence terakhir, aktivitas pemantauan harus berhenti.
Jika geofence berhasil dihapus, driver akan mengembalikan STATUS_SUCCESS. Jika geofence tidak dapat dihapus, kode kegagalan, STATUS_UNSUCCESSFUL, dikembalikan. Jika kegagalan terjadi, adaptor GNSS mengeluarkan perintah GNSS_ResetGeofencesTracking dan membuat ulang geofence yang diinginkan. Jika perintah ini menghapus geofence terakhir yang ditentukan, driver menghentikan pelacakan geofence.
Persyaratan
Persyaratan | Nilai |
---|---|
Header | gnssdriver.h (termasuk Gnssdriver.h) |
Lihat juga
Membuat Permintaan IOCTL di Driver
WdfIoTargetSendInternalIoctlOthersSynchronously
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
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:Kirim dan lihat umpan balik untuk