IOCTL_GNSS_DELETE_GEOFENCE IOCTL (gnssdriver.h)
GNSS 适配器使用 IOCTL_GNSS_DELETE_GEOFENCE 控制代码删除以前创建的地理围栏。
适用于 GNSS DDI 版本 2 及更高版本。
主要代码
输入缓冲区
指向 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命令并重新创建所需的地理围栏。 如果此命令删除最后一个定义的地理围栏,驱动程序将停止地理围栏跟踪。
要求
要求 | 值 |
---|---|
Header | gnssdriver.h (包括 Gnssdriver.h) |
另请参阅
WdfIoTargetSendInternalIoctlOthersSynchronously