IOCTL_GNSS_DELETE_GEOFENCE IOCTL (gnssdriver.h)

發行項
02/29/2024

GNSS 配接器會使用 IOCTL_GNSS_DELETE_GEOFENCE 控件程式代碼來刪除先前建立的地理柵欄。

適用於 GNSS DDI 第 2 版和更新版本。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

定義要刪除之地理柵欄之GNSS_GEOFENCE_DELETE_PARAM 結構的指標。

輸入緩衝區長度

設定為sizeof (GNSS_GEOFENCE_DELETE_PARAM) 。

輸出緩衝區

設定為 NULL。

輸出緩衝區長度

設定為 0。

狀態區塊

Irp->如果要求成功，IoStatus.Status 會設定為 STATUS_SUCCESS。否則，狀態為適當的錯誤狀況為 NTSTATUS 程式碼。

備註

具有下列指示的NTSTATUS：

STATUS_SUCCESS：驅動程式已成功移除地理柵欄。
STATUS_UNSUCCESSFUL：失敗，無法刪除地理柵欄。

GNSS 配接器附註

GNSS 配接器不會預期此呼叫失敗，因為沒有簡潔的方式可處理此失敗的結果。失敗時，GNSS 配接器會發出 GNSS_ResetGeofencesTracking 命令，然後重新新增地理柵欄。

GNSS 驅動程式注意事項

如果這是最後一個地理柵欄，GNSS 驅動程式應該停止地理柵欄追蹤。如果在刪除最後一個地理柵欄之前，GNSS 引擎無法追蹤地理柵欄 (，因為訊號狀況不良或其他暫時性錯誤) ，則監視活動應該會停止。

如果成功移除地理柵欄，驅動程式會傳回STATUS_SUCCESS。如果無法刪除地理柵欄，則會傳回失敗碼STATUS_UNSUCCESSFUL。如果發生失敗，GNSS 配接器會發出GNSS_ResetGeofencesTracking命令，然後重新建立所需的地理柵欄。如果此命令刪除最後定義的地理柵欄，驅動程式會停止地理柵欄追蹤。