GNSS_GEOFENCE_CREATE_PARAM Struktur (gnssdriver.h)

Die GNSS_GEOFENCE_CREATE_PARAM Struktur definiert die Parameter zum Erstellen eines Geofence-Bereichs im GNSS-Modul.

Syntax

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;

Angehörige

Size

Strukturgröße.

Version

Versionsnummer.

AlertTypes

Dies ist eine Bitmaske, die die verschiedenen Warnungen für diesen Geofence-Bereich angibt, an denen das HLOS interessiert ist. Das GNSS-Modul sollte keine Geofence-Warnungen auslösen, es sei denn, dies wird von der HLOS ausdrücklich angefordert.

Wenn das HLOS nur GNSS_GEOFENCEALERTTYPE_ENTRY festlegt, muss das GNSS-Modul den Geofence-Raum immer nachverfolgen, aber warnung nur dann auslösen, wenn das Gerät den Geofence-Wert eingegeben hat. Die nächste Warnung wird erwartet, wenn sich das Gerät aus dem Geofence-Bereich bewegt und wieder eingeht.

Wenn das HLOS nur GNSS_GEOFENCEALERTTYPE_EXIT festlegt, muss das GNSS-Modul den Geofence-Raum immer nachverfolgen, aber warnung nur dann auslösen, wenn das Gerät den Geofence-Wert verlassen hat, nachdem es zuvor eingegeben wurde. Die nächste Warnung wird erwartet, wenn das Gerät innerhalb des Geofence-Vorgangs bewegt und erneut beendet wird.

Wenn das HLOS beide Bitmasken festlegt, muss das GNSS-Modul den Geofence-Bereich immer nachverfolgen und warnungen auslösen, wenn sich das Gerät ein- und aus dem Geofence-Bereich bewegt.

In allen Fällen muss das GNSS-Modul die globale Tracking-Statuswarnung separat auslösen, wenn die Geofences (unabhängig von ihren Warnungseinstellungen) nicht nachverfolgt werden können.

InitialState

Gibt den Anfangszustand des spezifischen Geofence-Bereichs an, wie vom HLOS gesehen. Das GNSS-Modul muss diesen Zustand als Startzustand des Geofence-Bereichs verwenden, anstatt immer vom GNSS_GeofenceState_Unknown Zustand zu beginnen. Dies ermöglicht es dem GNSS-Modul, in Bezug auf die Geofence-Zustände mit dem HLOS in Verbindung zu bleiben und alle Unterschiede in der Geofence-Eingangs- oder Ausgangserkennungslogik zwischen dem GNSS-Modul und dem HLOS zu umgehen.

Wenn das GNSS-Modul beginnt, den neu hinzugefügten Geofence-Bereich nachzuverfolgen, sollte er die entsprechende Warnung auslösen, wenn er feststellt, dass sich der Geofence-Bereich in einem anderen Zustand befindet als dieser Anfangszustand. Wenn die Zustände identisch sind, sollte dagegen keine Warnung ausgelöst werden.

Boundary

Die tatsächliche Grenze des Geofence-Bereichs.

Unused[512]

Abstandspuffer, der für die zukünftige Verwendung reserviert ist.

Bemerkungen

Eine geografische Form wird verwendet, um einen Geofence-Bereich zu definieren. Windows 10 unterstützt derzeit nur zirkuläre Geofences.

Anforderungen

Anforderung	Wert
Header-	gnssdriver.h (include Gnssdriver.h)