IOCTL_GNSS_DELETE_GEOFENCE IOCTL (gnssdriver.h)

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命令,然後重新建立所需的地理柵欄。 如果此命令刪除最後定義的地理柵欄,驅動程式會停止地理柵欄追蹤。

必要條件

   
標頭 gnssdriver.h

另請參閱

在驅動程式中建立 IOCTL 要求

WdfIoTargetSendInternalIoctlOthersSynchronously

WdfIoTargetSendInternalIoctlSynchronously

WdfIoTargetSendIoctlSynchronously