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）