TimeSample-Struktur (timeprov.h)

  • Artikel

Stellt ein Zeitbeispiel dar.

Syntax

typedef struct TimeSample {
  DWORD            dwSize;
  DWORD            dwRefid;
  signed __int64   toOffset;
  signed __int64   toDelay;
  unsigned __int64 tpDispersion;
  unsigned __int64 nSysTickCount;
  signed __int64   nSysPhaseOffset;
  BYTE             nLeapFlags;
  BYTE             nStratum;
  DWORD            dwTSFlags;
  WCHAR            wszUniqueName[256];
} TimeSample;

Member

dwSize

Die Größe der Struktur in Bytes.

dwRefid

Ein Verweisbezeichner für die Zeitquelle im NTP-Format (entweder eine IP-Adresse oder eine vierstellige ASCII-Zeichenfolge, die die Hardwarequelle beschreibt, z. B. GPS oder WWVB).

toOffset

Der Unterschied zwischen lokalen und Remoteuhren in (10^-7)s.

toDelay

Die gesamte Roundtripverzögerung in (10^-7)s. Dies ist die Zeit, die Pakete während der Übertragung von der Stammzeitquelle zum Client verbringen, einschließlich der Stammverzögerung. Für NTP-Anbieter bedeutet dies eine Roundtripverzögerung zum Peer sowie die Stammverzögerung des Peers. Bei den Hardwareanbietern ist dieser Wert wahrscheinlich null.

tpDispersion

Der Gesamtmessungsfehler des Uhroffsets, einschließlich Wurzeldispersion, in (10^-7)s. Dazu gehören Fehler beim Lesen der lokalen Uhr, Unsicherheit in der lokalen Taktfrequenz und Fehler aus Filtern. Bei NTP-Anbietern umfasst dies die Stammstreuung des Peers.

nSysTickCount

Der von GetTimeSysInfo mit TSI_TickCount zurückgegebene Wert.

nSysPhaseOffset

Der von GetTimeSysInfo mit TSI_PhaseOffset zurückgegebene Wert.

nLeapFlags

Eine Variable, die eine bevorstehende Schalt sekunde oder einen Verlust der Synchronisierung angibt. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
0
 Keine Änderung.
1
 Schalt sekunde hinzufügen.
2
 Subtrahieren der Schalt sekunde.
3
 Nicht synchronisiert.

nStratum

Die Anzahl der Netzwerkhops, die diesen Computer von der Stammquelle trennen. Hardwareanbieter sollten null zurückgeben. NTP-Anbieter sollten die Stratum des Peers zurückgeben, der das Beispiel bereitgestellt hat.

dwTSFlags

Die Informationen zur Zeitquelle.

Wert Bedeutung
TSF_Authenticated
 Das Beispiel wurde kryptografisch authentifiziert.
TSF_Hardware
 Das Beispiel stammt von einem Hardwaregerät, z. B. einem GPS- oder Funkempfänger.

wszUniqueName[256]

Der Name, der die Quelle des Beispiels eindeutig identifiziert. Bei Netzwerkanbietern sollte der Name das Protokoll und die IP-Adressen enthalten. Bei Hardwaregeräten sollte der Name den Gerätenamen und den Kommunikationsport enthalten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile timeprov.h

Weitere Informationen

GetTimeSysInfoFunc

TpcGetSamplesArgs