IReferenceClock::AdviseTime 메서드

[이 페이지와 연결된 기능인 Windows Media Format 11 SDK는 레거시 기능입니다. 원본 판독기 및 싱크 작성기에 의해 대체되었습니다. 원본 판독기 및 싱크 작성기는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows Media Format 11 SDK 대신 소스 판독기 및 싱크 기록기를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

AdviseTime 메서드는 시간이 경과했다는 비동기 알림을 요청합니다.

구문

HRESULT AdviseTime(
  [in]  REFERENCE_TIME rtBaseTime,
  [in]  REFERENCE_TIME rtStreamTime,
  [in]  HEVENT         hEvent,
  [out] DWORD          *pdwAdviseCookie
);

매개 변수

rtBaseTime [in]

기본 참조 시간(100나노초 단위)입니다.

rtStreamTime [in]

스트림 오프셋 시간(100나노초 단위)입니다.

hEvent [in]

호출자가 만든 이벤트에 대한 핸들입니다. 이 이벤트는 지정된 시간이 경과하면 신호를 받게 됩니다.

pdwAdviseCookie [out]

요청에 대한 식별자를 수신하는 변수에 대한 포인터입니다. 예를 들어 요청을 취소하기 위해 나중에 AdviseTime 에 대한 이 호출을 식별하는 데 사용됩니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	설명
S_OK	메서드가 성공했습니다.
E_POINTER	pdwAdviseCookie 매개 변수는 NULL입니다.
E_FAIL	지정되지 않은 오류입니다.

추가 정보

IReferenceClock 인터페이스