IReferenceClock::AdviseTime

The IReferenceClock::AdviseTime method requests an asynchronous notification that a duration has elapsed.

HRESULT AdviseTime(
  REFERENCE_TIME rtBaseTime,
  REFERENCE_TIME rtStreamTime,
  HEVENT hEvent,
  DWORD * pdwAdviseCookie
);
 

Parameters

rtBaseTime

Base reference time.

rtStreamTime

Stream offset time.

hEvent

Handle of an event through which to advise.

pdwAdviseCookie

Address of a variable to receive the identifier of the request. This is used to identify this call to AdviseTime in the future—for example, to cancel it.

Return Values

Return values are determined by the implementation. If the method succeeds, it returns S_OK. If it fails, it may return one of the following error values:

Remarks

When the time rtBaseTime + rtStreamTime is reached, the event whose handle is hEvent will be set. If the time has already passed, the event will be set immediately.

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmusicc.h.

See Also

IReferenceClock::Unadvise