GNSS_EVENT_TYPE枚举 （gnssdriver.h）

此枚举指示事件的类型，并由 GNSS_EVENT 结构使用。

GNSS 驱动程序利用事件将请求和未经请求的信息发送到 GNSS 适配器。 由于各种原因（例如，向 GNSS 适配器请求驱动程序以注入帮助数据或出于信息性目的），可能会发生事件。

语法

typedef enum {
  GNSS_Event_FixAvailable,
  GNSS_Event_RequireAgnss,
  GNSS_Event_Error,
  GNSS_Event_NiRequest,
  GNSS_Event_NmeaData,
  GNSS_Event_GeofenceAlertData,
  GNSS_Event_GeofencesTrackingStatus,
  GNSS_Event_DriverRequest,
  GNSS_Event_BreadcrumbAlertEvent,
  GNSS_Event_FixAvailable_2,
  GNSS_Event_Custom
} GNSS_EVENT_TYPE;

常数

GNSS_Event_FixAvailable 由于来自适配器的先前 IOCTL_GNSS_GET_FIXDATA 调用，将引发此事件。 当适配器可用于收集修补程序时，GNSS 驱动程序将引发此事件。 修复数据以 GNSS_FIXDATA 结构的形式包含在事件数据中。
GNSS_Event_RequireAgnss 此事件是由适配器先前的 IOCTL_GNSS_LISTEN_AGNSS 调用引发的。 每当驱动程序需要注入某些 AGNSS 协助数据时，驱动程序都引发此事件。 注入的具体内容以 GNSS_AGNSS_REQUEST_PARAM 结构的形式出现在事件数据中。
GNSS_Event_Error 由于来自适配器的先前 IOCTL_GNSS_LISTEN_ERROR 调用，将引发此事件。 当发生适配器需要注意的带外错误时，驱动程序将引发此事件。 错误详细信息以 GNSS_ERRORINFO 结构的形式出现在事件数据中。 Microsoft可以使用这些信息来捕获有关不同设备在字段中看到的错误类型的遥测数据，并且可以与 OEM/IHV 共享数据，以帮助了解常见问题并提高 GNSS 引擎实现的质量。
GNSS_Event_NiRequest 当驱动程序想要通知 NI 请求时，将引发此事件。 HLOS 将处理请求（例如，如果请求显示对话框），然后将响应注入到驱动程序。
GNSS_Event_NmeaData 如果在设备中启用了 NMEA 日志记录，则由于之前的 IOCTL_GNSS_LISTEN_NMEA 调用而引发此事件。 当 NMEA 数据准备好由调用客户端读取时，GNSS 驱动程序将引发此事件。 调用客户端通常是测试工具。 NMEA 句子数据以 GNSS_NMEA_DATA 结构的形式包含在事件数据中。
GNSS_Event_GeofenceAlertData 以前创建的地理围栏已遭到破坏。 在地理围栏的创建时，HLOS 专门要求在发生此类违规时发出警报。 例如，如果 HLOS 仅请求退出警报，则不应引发条目警报。
GNSS_Event_GeofencesTrackingStatus 由于信号条件不佳或其他定位问题，GNSS 引擎无法跟踪一个或多个地理围栏。 当 GNSS 引擎从以前的故障条件中恢复并且现在能够跟踪所有地理围栏时，也会引发状态。
GNSS_Event_DriverRequest 保留为将来的扩展。 GNSS 驱动程序正在从 HLOS 请求一些带外信息。
GNSS_Event_BreadcrumbAlertEvent 保留为将来的扩展：0x0012 0x7FFF。 对于每个新事件类型，将有一个定义完善的 IOCTL，描述适配器对此事件的启动过程，以及一个定义完善的事件数据结构，描述与此事件关联的数据/命令。
GNSS_Event_FixAvailable_2 GNSS_FIXDATA_2 结构中的事件数据中包含的修复数据。
GNSS_Event_Custom 为特定于供应商的自定义作保留：0x8000 0xFFFF。 GNSS 驱动程序根据需要引发此事件。 命令和数据作为事件数据的一部分打包在不透明 Blob 中。 包将发送到适配器，用于封送到 GNSS 帮助程序组件。

言论

事件可以是各种类型的。 某些事件是由驱动程序启动的先前请求导致的，例如启动修复请求。 出于信息性目的，将引发某些事件。 当驱动程序需要适配器注入特定协助数据时，将引发协助事件。

要求

要求	价值
支持的最低服务器	Windows Server 2022
标头	gnssdriver.h （包括 Gnssdriver.h）