structure GNSS_GEOFENCE_CREATE_PARAM (driver.h)

La structure GNSS_GEOFENCE_CREATE_PARAM définit les paramètres de création d’une limite géographique dans le moteur SEE.

Syntaxe

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;

Membres

Size

Taille de la structure.

Version

Numéro de version.

AlertTypes

Il s’agit d’un masque de bits qui indique les différentes alertes pour cette limite géographique qui intéresse le HLOS. Le moteur ANALYTICS ne doit déclencher aucune alerte de limite géographique, sauf si elle est spécifiquement demandée par le HLOS.

Si le HLOS définit uniquement GNSS_GEOFENCEALERTTYPE_ENTRY, le moteur INTEROPÉRABILITÉ doit suivre la limite géographique tout le temps, mais déclencher une alerte uniquement lorsque l’appareil a entré la limite géographique. L’alerte suivante est attendue lorsque l’appareil quitte la limite géographique et les réenters.

Si le HLOS définit uniquement GNSS_GEOFENCEALERTTYPE_EXIT, le moteur SECOURS doit suivre la limite géographique tout le temps, mais déclencher une alerte uniquement lorsque l’appareil a quitté la limite géographique après l’avoir entré précédemment. L’alerte suivante est attendue lorsque l’appareil se déplace à l’intérieur de la limite géographique et quitte à nouveau.

Si le HLOS définit les deux masques de bits, le moteur SEE doit suivre la limite géographique tout le temps et déclencher l’alerte lorsque l’appareil se déplace vers et hors de la limite géographique.

Dans tous les cas, le moteur SEE doit déclencher séparément l’alerte d’état de suivi global s’il n’est pas en mesure de suivre les limites géographiques (indépendamment de leurs paramètres d’alerte).

InitialState

Indique l’état initial de la limite géographique spécifique, comme indiqué par le HLOS. Le moteur INTEROPÉRABILITÉ doit utiliser cet état comme état de départ de la limite géographique, par opposition à partir de l’état GNSS_GeofenceState_Unknown. Cela permet au moteur SEE de rester synchronisé avec le HLOS en termes d’états de limite géographique et de contourner toutes les différences dans la logique d’entrée de limite géographique ou de détection de sortie entre le moteur SEE et le HLOS.

Lorsque le moteur SEE commence à suivre la limite géographique nouvellement ajoutée, s’il détermine que la limite géographique est dans un état différent de celui de cet état initial, elle doit déclencher l’alerte appropriée. À l’inverse, si les états sont identiques, aucune alerte ne doit être déclenchée.

Boundary

Limite réelle de la limite géographique.

Unused[512]

Mémoire tampon de remplissage réservée pour une utilisation ultérieure.

Remarques

Une forme géographique est utilisée pour définir une limite géographique. Windows 10 prend actuellement en charge uniquement les limites géographiques circulaires.

Exigences

Exigence	Valeur
d’en-tête	driver.h (include Messagedriver.h)