다음을 통해 공유


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)의 로컬 클록과 원격 클록의 차이입니다.

toDelay

총 왕복 지연(10^-7)입니다. 루트 지연을 포함하여 루트 시간 원본에서 클라이언트로 전송하는 데 소요된 시간 패킷입니다. NTP 공급자의 경우 이는 피어에 대한 왕복 지연과 피어의 루트 지연을 의미합니다. 하드웨어 공급자인 이 값은 0일 수 있습니다.

tpDispersion

(10^-7)s에서 루트 분산을 포함한 클록 오프셋의 총 측정 오차입니다. 여기에는 로컬 클록을 읽는 오류, 로컬 클록 빈도의 불확실성 및 필터의 오류가 포함됩니다. NTP 공급자의 경우 피어의 루트 분산이 포함됩니다.

nSysTickCount

TSI_TickCount GetTimeSysInfo에서 반환된 값입니다.

nSysPhaseOffset

TSI_PhaseOffset GetTimeSysInfo에서 반환된 값입니다.

nLeapFlags

임박한 윤초 또는 동기화 손실을 나타내는 변수입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

의미
0
변경되지 않았습니다.
1
윤초를 추가합니다.
2
윤초를 뺍니다.
3
동기화되지 않았습니다.

nStratum

이 컴퓨터를 루트 원본에서 분리하는 네트워크 홉 수입니다. 하드웨어 공급자는 0을 반환해야 합니다. NTP 공급자는 샘플을 제공한 피어의 계층을 반환해야 합니다.

dwTSFlags

시간 원본에 대한 정보입니다.

의미
TSF_Authenticated
샘플은 암호화 인증되었습니다.
TSF_Hardware
샘플은 GPS 또는 라디오 수신기와 같은 하드웨어 장치에서 가져옵니다.

wszUniqueName[256]

샘플의 원본을 고유하게 식별하는 이름입니다. 네트워크 공급자의 경우 이름에 프로토콜 및 IP 주소가 포함되어야 합니다. 하드웨어 디바이스의 경우 이름에 디바이스 이름 및 통신 포트가 포함되어야 합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 timeprov.h

추가 정보

GetTimeSysInfoFunc

TpcGetSamplesArgs