GNSS_GEOFENCE_CREATE_PARAM-Struktur (GNSSDRIVER.h)

Die GNSS_GEOFENCE_CREATE_PARAM-Struktur definiert die Parameter zum Erstellen eines Geofences in der GNSS-Engine.

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;

Member

Size

Strukturgröße.

Version

Versionsnummer:

AlertTypes

Dies ist eine Bitmaske, die die verschiedenen Warnungen für diesen Geofence angibt, an denen der HLOS interessiert ist. Die GNSS-Engine sollte keine Geofencewarnungen auslösen, es sei denn, dies wird vom HLOS ausdrücklich angefordert.

Wenn der HLOS nur GNSS_GEOFENCEALERTTYPE_ENTRY festlegt, muss die GNSS-Engine den Geofence die ganze Zeit nachverfolgen, aber eine Warnung nur auslösen, wenn das Gerät den Geofence eingegeben hat. Die nächste Warnung wird erwartet, wenn sich das Gerät aus dem Geofence und dem Reenter bewegt.

Wenn der HLOS nur GNSS_GEOFENCEALERTTYPE_EXIT festlegt, muss die GNSS-Engine den Geofence die ganze Zeit nachverfolgen, aber eine Warnung nur auslösen, wenn das Gerät den Geofence nach vorheriger Eingabe verlassen hat. Die nächste Warnung wird erwartet, wenn sich das Gerät innerhalb des Geofences bewegt und erneut beendet wird.

Wenn der HLOS beide Bitmasken festlegt, muss die GNSS-Engine den Geofence ständig nachverfolgen und Warnungen auslösen, wenn sich das Gerät in und aus dem Geofence bewegt.

In allen Fällen muss die GNSS-Engine die globale Nachverfolgung status Warnung separat auslösen, wenn sie die Geofences nicht nachverfolgen kann (unabhängig von ihren Warnungseinstellungen).

InitialState

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

Wenn die GNSS-Engine mit der Nachverfolgung des neu hinzugefügten Geofence beginnt, sollte die entsprechende Warnung ausgelöst werden, wenn sie feststellt, dass sich der Geofence in einem anderen Zustand als dieser Anfangszustand befindet. Wenn die Zustände identisch sind, sollte keine Warnung ausgelöst werden.

Boundary

Die tatsächliche Grenze des Geofences.

Unused[512]

Puffer für die zukünftige Verwendung reserviert.

Hinweise

Ein geografisches Shape wird verwendet, um einen Geofence zu definieren. Windows 10 unterstützt derzeit nur zirkuläre Geofences.

Anforderungen

Anforderung	Wert
Header	gnssdriver.h (einschließlich GNSSdriver.h)