struttura GNSS_GEOFENCE_CREATE_PARAM (gnssdriver.h)

La struttura GNSS_GEOFENCE_CREATE_PARAM definisce i parametri per la creazione di un recinto virtuale nel motore GNSS.

Sintassi

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;

Membri

Size

Dimensioni della struttura.

Version

Numero di versione.

AlertTypes

Si tratta di una maschera di bit che indica i vari avvisi per questo recinto virtuale a cui è interessato HLOS. Il motore GNSS non deve generare avvisi di recinto virtuale, a meno che non venga richiesto in modo specifico dal servizio HLOS.

Se il servizio HLOS imposta solo GNSS_GEOFENCEALERTTYPE_ENTRY, il motore GNSS deve tenere traccia del recinto virtuale per tutto il tempo, ma generare un avviso solo quando il dispositivo è entrato nel recinto virtuale. L'avviso successivo è previsto quando il dispositivo si sposta all'esterno del recinto virtuale e dei reenter.

Se il modulo HLOS imposta solo GNSS_GEOFENCEALERTTYPE_EXIT, il motore GNSS deve tenere traccia del recinto virtuale per tutto il tempo, ma generare un avviso solo quando il dispositivo ha chiuso il recinto virtuale dopo averlo immesso in precedenza. L'avviso successivo è previsto quando il dispositivo si sposta all'interno del recinto virtuale e si chiude nuovamente.

Se HLOS imposta entrambe le maschera di bit, il motore GNSS deve tenere traccia del recinto virtuale per tutto il tempo e generare un avviso man mano che il dispositivo si sposta all'interno e all'esterno del recinto virtuale.

In tutti i casi, il motore GNSS deve generare separatamente l'avviso di stato di rilevamento globale se non è in grado di tenere traccia dei recinti virtuali (indipendentemente dalle impostazioni di avviso).

InitialState

Indica lo stato iniziale del recinto virtuale specifico, come illustrato da HLOS. Il motore GNSS deve usare questo stato come stato iniziale del recinto virtuale, invece di partire sempre dallo stato di GNSS_GeofenceState_Unknown. In questo modo il motore GNSS può rimanere sincronizzato con HLOS in termini di stati di recinto virtuale e aggirare eventuali differenze nella logica di rilevamento del recinto virtuale o di uscita tra il motore GNSS e HLOS.

Quando il motore GNSS avvia il rilevamento del recinto virtuale appena aggiunto, se determina che il recinto virtuale si trova in uno stato diverso da quello iniziale, dovrebbe generare l'avviso appropriato. Viceversa, se gli stati sono identici, non deve essere generato alcun avviso.

Boundary

Limite effettivo del recinto virtuale.

Unused[512]

Buffer di riempimento riservato per uso futuro.

Osservazioni

Una forma geografica viene usata per definire un recinto virtuale. Windows 10 supporta attualmente solo recinti virtuali circolari.

Fabbisogno

Requisito	Valore
intestazione	gnssdriver.h (include Gnssdriver.h)