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

GetTimeSysInfo 與 TSI_TickCount 傳回的值。

nSysPhaseOffset

GetTimeSysInfo 與 TSI_PhaseOffset 傳回的值。

nLeapFlags

變數，表示即將發生的閏秒或同步處理遺失。 這個成員可以是下列其中一個值。

值 意義
0
 沒有變更。
1
 新增 leap second。
2
 減去閏秒。
3
 未同步處理。

nStratum

將這部計算機與根來源分隔的網路躍點數目。 硬體提供者應該傳回零。 NTP 提供者應該傳回提供範例的對等階層。

dwTSFlags

時間來源的相關信息。

值 意義
TSF_Authenticated
 此範例已經過密碼編譯驗證。
TSF_Hardware
 此範例來自 GPS 或無線電接收器等硬體裝置。

wszUniqueName[256]

唯一識別樣本來源的名稱。 對於網路提供者，名稱應包含通訊協定和IP位址。 針對硬體裝置，名稱應包含裝置名稱和通訊埠。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 timeprov.h

另請參閱

GetTimeSysInfoFunc

TpcGetSamplesArgs