Condividi tramite

struttura GNSS_FIXSESSION_PARAM (gnssdriver.h)

  • Articolo

Questa struttura definisce i parametri usati dall'adapter GNSS per avviare una sessione di correzione.

Sintassi

typedef struct {
  ULONG               Size;
  ULONG               Version;
  ULONG               FixSessionID;
  GNSS_FIXSESSIONTYPE SessionType;
  ULONG               HorizontalAccuracy;
  ULONG               HorizontalConfidence;
  ULONG               Reserved[9];
  ULONG               FixLevelOfDetails;
  union {
    GNSS_SINGLESHOT_PARAM         SingleShotParam;
    GNSS_DISTANCETRACKING_PARAM   DistanceParam;
    GNSS_CONTINUOUSTRACKING_PARAM ContinuousParam;
    GNSS_LKGFIX_PARAM             LkgFixParam;
    BYTE                          UnusedParam[268];
  };
  BYTE                Unused[256];
} GNSS_FIXSESSION_PARAM, *PGNSS_FIXSESSION_PARAM;

Membri

Size

Dimensioni della struttura.

Version

Numero di versione.

FixSessionID

Si tratta di un identificatore univoco per una determinata sessione di correzione.

L'adattatore GNSS genera questo numero in un ordine in aumento monotonico ogni volta che viene richiesta una nuova sessione di correzione. Il numero viene disposto intorno a zero. Data la durata di una sessione attiva e il numero di sessioni parallele possibili anche con supporto multisessione, il wrapping è accettabile in questo caso d'uso.

Il driver GNSS deve associare tutti i dati correlati alle correzioni alla sessione di correzione originale usando il campo FixSessionID. Se il driver GNSS non supporta più sessioni di correzione, può usare l'ID sessione dell'ultima richiesta di sessione di correzione.

SessionType

Identifica il tipo o il tipo di ricorrenza di questa sessione di correzione.

HorizontalAccuracy

L'accuratezza orizzontale della correzione richiesta è solo informazioni di consulenza per il driver GNSS che può essere usato in modo specifico dell'implementazione per fare compromessi appropriati internamente per soddisfare la richiesta.

Un valore pari a 0 indica che non è prevista alcuna precisione specifica dall'adattatore GNSS.

HorizontalConfidence

L'attendibilità orizzontale è la confidenza circolare richiesta per questa correzione.

La piattaforma prevede correzioni con 95% confidenza. Il driver GNSS deve rispettare questo valore di attendibilità quando restituisce la correzione e l'accuratezza dal motore GNSS.

Reserved[9]

Buffer di riempimento riservato per uso futuro.

FixLevelOfDetails

Indica il livello di dettaglio necessario quando il driver GNSS restituisce le informazioni di correzione.

Il driver GNSS può scegliere di eseguire l'override di questo input.

Questo flag è OR-ed con i valori di bit definiti in GNSS_FIXDETAIL_* mask.

SingleShotParam

La struttura GNSS_SINGLESHOT_PARAM definisce i parametri per una sessione di correzione singola.

DistanceParam

La struttura GNSS_DISTANCETRACKING_PARAM definisce i parametri per una sessione di correzione basata sulla distanza.

ContinuousParam

La struttura GNSS_CONTINUOUSTRACKING_PARAM definisce i parametri per una sessione di correzione continua del rilevamento.

LkgFixParam

La struttura GNSS_LKGFIX_PARAM non viene attualmente utilizzata dal sistema.

UnusedParam[268]

Buffer di riempimento riservato per uso futuro.

Unused[256]

Buffer di riempimento riservato per uso futuro.

Osservazioni

I parametri della sessione di correzione sono diversi per diversi tipi di sessioni. Questa struttura contiene un set comune di parametri applicabili per tutte le sessioni di correzione, seguito da una struttura di overload (unione) per ogni tipo di sessione di correzione. Il driver GNSS deve usare la struttura appropriata dall'unione a seconda del tipo di sessione.

Fabbisogno

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