Структура TimeSample (timeprov.h)

Статья
08/26/2023

Представляет пример времени.

Синтаксис

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;

Члены

dwSize

Размер структуры в байтах.

dwRefid

Идентификатор ссылки для источника времени в формате NTP (IP-адрес или строка ASCII из четырех символов, описывающая источник оборудования, например GPS или WWVB).

toOffset

Разница между локальными и удаленными часами в (10^-7)s.

toDelay

Общая задержка кругового пути в (10^-7)с. Это время, затраченное на передачу пакетов из корневого источника времени в клиент, включая корневую задержку. Для поставщиков NTP это означает задержку обратной связи до однорангового узла, а также корневую задержку однорангового узла. Поставщики оборудования, это значение, вероятно, равно нулю.

tpDispersion

Общая погрешность измерения смещения часов, включая корневую дисперсию, в (10^-7)с. К ним относятся ошибки при чтении локальных часов, неопределенность в локальной частоте часов и ошибка из фильтров. Для поставщиков NTP это включает корневую дисперсию однорангового узла.

nSysTickCount

Значение, возвращаемое getTimeSysInfo с TSI_TickCount.

nSysPhaseOffset

Значение, возвращаемое GetTimeSysInfo с TSI_PhaseOffset.

nLeapFlags

Переменная, указывающая на предстоящее корректировочную секунду или потерю синхронизации. Этот элемент может иметь одно из следующих значений.

Значение	Значение
0	Без изменений.
1	Добавьте високосную секунду.
2	Вычесть корректировочную секунду.
3	Не синхронизировано.

nStratum

Количество сетевых прыжков, отделяющих этот компьютер от корневого источника. Поставщики оборудования должны возвращать ноль. Поставщики NTP должны возвращать слой однорангового узла, который предоставил пример.

dwTSFlags

Сведения об источнике времени.

Значение	Значение
TSF_Authenticated	Пример прошел криптографическую проверку подлинности.
TSF_Hardware	Образец получен из аппаратного устройства, такого как GPS или радиоприемник.

wszUniqueName[256]

Имя, однозначно определяющее источник образца. Для поставщиков сетей имя должно включать протокол и IP-адреса. Для аппаратных устройств имя должно включать имя устройства и порт связи.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	timeprov.h

См. также раздел

GetTimeSysInfoFunc

TpcGetSamplesArgs

Поделиться через