Bagikan melalui

Struktur TimeSample (timeprov.h)

  • Artikel

Mewakili sampel waktu.

Sintaks

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;

Anggota

dwSize

Ukuran struktur, dalam byte.

dwRefid

Pengidentifikasi referensi untuk sumber waktu, dalam format NTP (baik alamat IP atau string ASCII empat karakter yang menjelaskan sumber perangkat keras, seperti GPS atau WWVB).

toOffset

Perbedaan antara jam lokal dan jarak jauh, dalam (10^-7)s.

toDelay

Total penundaan pulang-pergi, dalam (10^-7)s. Ini adalah waktu yang dihabiskan paket saat transit dari sumber waktu akar ke klien, termasuk penundaan akar. Untuk penyedia NTP, ini berarti penundaan pulang pergi ke serekan, ditambah penundaan akar serekan. Penyedia perangkat keras, nilai ini mungkin nol.

tpDispersion

Kesalahan pengukuran total offset jam, termasuk dispersi akar, dalam (10^-7)s. Ini termasuk kesalahan dalam membaca jam lokal, ketidakpastian dalam frekuensi jam lokal, dan kesalahan dari filter. Untuk penyedia NTP, ini termasuk dispersi akar serekan.

nSysTickCount

Nilai yang dikembalikan oleh GetTimeSysInfo dengan TSI_TickCount.

nSysPhaseOffset

Nilai yang dikembalikan oleh GetTimeSysInfo dengan TSI_PhaseOffset.

nLeapFlags

Variabel yang menunjukkan lompatan kedua yang akan terjadi atau hilangnya sinkronisasi. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai Makna
0
 Tidak Ada Perubahan.
1
 Tambahkan lompatan kedua.
2
 Kurangi lompatan kedua.
3
 Tidak disinkronkan.

nStratum

Jumlah hop jaringan yang memisahkan komputer ini dari sumber akar. Penyedia perangkat keras harus mengembalikan nol. Penyedia NTP harus mengembalikan stratum serekan yang menyediakan sampel.

dwTSFlags

Informasi tentang sumber waktu.

Nilai Makna
TSF_Authenticated
 Sampel telah diautentikasi secara kriptografis.
TSF_Hardware
 Sampel berasal dari perangkat keras seperti GPS atau penerima radio.

wszUniqueName[256]

Nama yang secara unik mengidentifikasi sumber sampel. Untuk penyedia jaringan, nama harus menyertakan protokol dan alamat IP. Untuk perangkat keras, nama harus menyertakan nama perangkat dan port komunikasi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header timeprov.h

Lihat juga

GetTimeSysInfoFunc

TpcGetSamplesArgs