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

IRP_MJ_DEVICE_CONTROL

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

WdfIoTargetSendInternalIoctlSynchronously

WdfIoTargetSendIoctlSynchronously