GNSS_FIXSESSION_PARAM-Struktur (gnssdriver.h)

Diese Struktur definiert die Parameter, die vom GNSS-Adapter zum Starten einer Fixsitzung verwendet werden.

Syntax

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;

Member

Size

Strukturgröße.

Version

Versionsnummer:

FixSessionID

Dies ist ein eindeutiger Bezeichner für eine bestimmte Fixsitzung.

Der GNSS-Adapter generiert diese Zahl in monoton steigender Reihenfolge, wenn eine neue Fixsitzung angefordert wird. Die Zahl wird um 0 (null) umbrochen. Angesichts der Lebensdauer einer aktiven Sitzung und der Anzahl möglicher paralleler Sitzungen, selbst bei Unterstützung mehrerer Sitzungen, ist der Umbruch in diesem Anwendungsfall akzeptabel.

Der GNSS-Treiber muss alle Fixdaten der ursprünglichen Fixsitzung mithilfe des Felds FixSessionID zuordnen. Wenn der GNSS-Treiber mehrere Fixsitzungen nicht unterstützt, kann er die Sitzungs-ID der letzten Fixsitzungsanforderung verwenden.

SessionType

Gibt den Typ oder wiederholungstyp dieser Fixsitzung an.

HorizontalAccuracy

Die horizontale Genauigkeit der angeforderten Korrektur ist nur Beratungsinformationen für den GNSS-Treiber, die auf implementierungsspezifische Weise verwendet werden können, um intern geeignete Kompromisse zu treffen, um die Anforderung zu erfüllen.

Der Wert 0 gibt an, dass vom GNSS-Adapter keine bestimmte Genauigkeit vorgeschrieben wird.

HorizontalConfidence

Die horizontale Konfidenz ist die kreisförmige Konfidenz, die für diese Korrektur angefordert wird.

Die Plattform erwartet Korrekturen mit einer Zuverlässigkeit von 95 %. Der GNSS-Treiber sollte diesen Konfidenzwert berücksichtigen, wenn er die Korrektur und Genauigkeit von der GNSS-Engine zurückgibt.

Reserved[9]

Für die zukünftige Verwendung reservierter Puffer.

FixLevelOfDetails

Gibt die Detailebene an, die erforderlich ist, wenn der GNSS-Treiber die Korrekturinformationen zurückgibt.

Der GNSS-Treiber kann diese Eingabe außer Kraft setzen.

Dieses Flag wird mit den in GNSS_FIXDETAIL_*-Maske definierten Bitwerten OR-eded.

SingleShotParam

Die GNSS_SINGLESHOT_PARAM-Struktur definiert die Parameter für eine Single-Shot-Fixsitzung.

DistanceParam

Die GNSS_DISTANCETRACKING_PARAM-Struktur definiert die Parameter für eine entfernungsbasierte Nachverfolgungskorrektursitzung.

ContinuousParam

Die GNSS_CONTINUOUSTRACKING_PARAM-Struktur definiert die Parameter für eine fortlaufende Nachverfolgungskorrektursitzung.

LkgFixParam

Die GNSS_LKGFIX_PARAM-Struktur wird derzeit nicht vom System verwendet.

UnusedParam[268]

Für die zukünftige Verwendung reservierter Puffer.

Unused[256]

Für die zukünftige Verwendung reservierter Puffer.

Hinweise

Die Fixsitzungsparameter unterscheiden sich für verschiedene Arten von Sitzungen. Diese Struktur enthält einen gemeinsamen Satz von Parametern, die für alle Fixsitzungen gelten, gefolgt von einer überladenen Struktur (Union) für jeden Fixsitzungstyp. Der GNSS-Treiber muss abhängig vom Sitzungstyp die entsprechende Struktur aus der Union verwenden.

Anforderungen

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