TimeSample-Struktur (timeprov.h)
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 |
|---|---|
|
Keine Änderung. |
|
Schalt sekunde hinzufügen. |
|
Subtrahieren der Schalt sekunde. |
|
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 |
|---|---|
|
Das Beispiel wurde kryptografisch authentifiziert. |
|
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 |