The AdviseTime method requests an asynchronous notification that a time has elapsed.
HRESULT AdviseTime( REFERENCE_TIME baseTime, REFERENCE_TIME streamTime, HANDLE hEvent, DWORD * pdwAdviseCookie );
Base reference time.
Stream offset time.
Handle to an event through which to advise.
Address of a variable that receives the identifier of the request. This is used to identify this call to AdviseTime in the future—for example, to cancel it.
Return values are determined by the implementation. If the method succeeds, it returns S_OK.
If it fails, the method can return one of the error values shown in the following table.
When the time baseTime plus streamTime is reached, the event whose handle is hEvent is set. If the time has already passed, the event is set immediately.
** Header:** Dmusicc.h