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 アドレスまたは GPS や WWVB などのハードウェア ソースを記述する 4 文字の ASCII 文字列)。
toOffset
(10^-7)s のローカル クロックとリモート クロックの違い。
toDelay
ラウンドトリップ遅延の合計 (10^-7)秒。 これは、ルートの遅延を含む、ルートタイムソースからクライアントへのパケットの転送に費やされた時間です。 NTP プロバイダーの場合、これはピアへのラウンドトリップ遅延とピアのルート遅延を意味します。 ハードウェア プロバイダーでは、この値はおそらく 0 です。
tpDispersion
(10^-7)s のクロック オフセット (ルート分散を含む) の合計測定誤差。 これには、ローカル クロックの読み取り時のエラー、ローカル クロック周波数の不確実性、フィルターからのエラーが含まれます。 NTP プロバイダーの場合、これにはピアのルート分散が含まれます。
nSysTickCount
GetTimeSysInfo によってTSI_TickCountで返される値。
nSysPhaseOffset
GetTimeSysInfo によってTSI_PhaseOffsetで返される値。
nLeapFlags
差し迫ったうるう秒または同期の損失を示す変数。 このメンバーには、次のいずれかの値を指定できます。
値 | 意味 |
---|---|
|
変更はありません。 |
|
うるう秒を追加します。 |
|
うるう秒を減算します。 |
|
同期されていません。 |
nStratum
このコンピューターをルート ソースから分離するネットワーク ホップの数。 ハードウェア プロバイダーは 0 を返す必要があります。 NTP プロバイダーは、サンプルを提供したピアの階層を返す必要があります。
dwTSFlags
タイム ソースに関する情報。
値 | 意味 |
---|---|
|
サンプルは暗号化で認証されています。 |
|
サンプルは、GPS や無線受信機などのハードウェア デバイスからのサンプルです。 |
wszUniqueName[256]
サンプルのソースを一意に識別する名前。 ネットワーク プロバイダーの場合、名前にはプロトコルと IP アドレスを含める必要があります。 ハードウェア デバイスの場合、名前にはデバイス名と通信ポートを含める必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
Header | timeprov.h |