通过

TimeSample 结构 (timeprov.h)

  • 项目

表示时间样本。

语法

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) 秒。

toDelay

总往返延迟， (10^-7) 秒。 这是数据包从根时间源传输到客户端所用的时间，包括根延迟。 对于 NTP 提供程序，这意味着到对等方的往返延迟以及对等的根延迟。 对于硬件提供程序，此值可能为零。

tpDispersion

时钟偏移量（包括根色散）的总测量误差 (10^-7) 秒。 这包括读取本地时钟的错误、本地时钟频率的不确定性以及来自筛选器的错误。 对于 NTP 提供程序，这包括对等的根分散。

nSysTickCount

具有 TSI_TickCount 的 GetTimeSysInfo 返回的值。

nSysPhaseOffset

具有 TSI_PhaseOffset 的 GetTimeSysInfo 返回的值。

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