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）