GNSS_GEOFENCE_CREATE_PARAM结构（gnssdriver.h）

GNSS_GEOFENCE_CREATE_PARAM 结构定义用于在 GNSS 引擎中创建地理围栏的参数。

语法

typedef struct {
  ULONG               Size;
  ULONG               Version;
  ULONG               AlertTypes;
  GNSS_GEOFENCE_STATE InitialState;
  GNSS_GEOREGION      Boundary;
  BYTE                Unused[512];
} GNSS_GEOFENCE_CREATE_PARAM, *PGNSS_GEOFENCE_CREATE_PARAM;

成员

Size

结构大小。

Version

版本号。

AlertTypes

这是一个位掩码，指示 HLOS 感兴趣的此地理围栏的各种警报。 除非 HLOS 特别请求，否则 GNSS 引擎不应引发任何地理围栏警报。

如果 HLOS 仅设置GNSS_GEOFENCEALERTTYPE_ENTRY，则 GNSS 引擎必须一直跟踪地理围栏，但仅在设备进入地理围栏时才发出警报。 当设备移出地理围栏和重新输入器时，预期会出现下一个警报。

如果 HLOS 仅设置GNSS_GEOFENCEALERTTYPE_EXIT，则 GNSS 引擎必须一直跟踪地理围栏，但仅在设备之前输入地理围栏后退出地理围栏时才发出警报。 当设备在地理围栏内移动并重新退出时，预期会出现下一个警报。

如果 HLOS 同时设置位掩码，则 GNSS 引擎必须一直跟踪地理围栏，并在设备进出地理围栏时发出警报。

在所有情况下，如果 GNSS 引擎无法跟踪地理围栏（无论其警报设置如何），则必须单独引发全局跟踪状态警报。

InitialState

指示特定地理围栏的初始状态，如 HLOS 所示。 GNSS 引擎必须使用此状态作为地理围栏的起始状态，而不是始终从GNSS_GeofenceState_Unknown状态开始。 这样，GNSS 引擎就可以在地理围栏状态方面与 HLOS 保持同步，并绕过 GNSS 引擎与 HLOS 之间的地理围栏进入或退出检测逻辑的任何差异。

当 GNSS 引擎开始跟踪新添加的地理围栏时，如果确定地理围栏的状态与此初始状态不同，则应引发相应的警报。 相反，如果状态相同，则不应引发警报。

Boundary

地理围栏的实际边界。

Unused[512]

保留的填充缓冲区供将来使用。

言论

地理形状用于定义地理围栏。 Windows 10 目前仅支持圆形地理围栏。

要求

要求	价值
标头	gnssdriver.h （包括 Gnssdriver.h）