CBaseReferenceClock::AdviseTime

  • Article

Sets up a one-shot notification with the clock.

HRESULT AdviseTime(
  REFERENCE_TIME baseTime,
  REFERENCE_TIME streamTime,
  HEVENT hEvent,
  DWORD* pdwAdviseToken
);

Parameters

  • baseTime
    Base reference time.
  • streamTime
    Stream offset time.
  • hEvent
    Advise through this event.
  • pdwAdviseToken
    Where the advise token goes.

Return Values

Returns one of the following HRESULT values.

E_OUTOFMEMORY Out of memory.
E_INVALIDARG Invalid argument.
NOERROR No error.

Remarks

This member function implements the IReferenceClock::AdviseTime method. At the time specified in the baseTime plus the streamTime parameters, the event specified in hEvent will be set. It is correct to call CBaseReferenceClock::Unadvise to remove the link after the event has occurred, but it is not necessary. One-shot notifications are automatically cleared by the clock once they have signaled.

To cancel a one-shot notification before the time is reached, call Unadvise and pass the pdwAdviseToken value returned from this call.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.