Microsoft DirectX 8.0 (C++) |
Requests an asynchronous notification that a time has elapsed.
HRESULT AdviseTime( REFERENCE_TIME rtBaseTime, REFERENCE_TIME rtStreamTime, HANDLE hEvent, DWORD * pdwAdviseCookie );
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 following error values:
E_FAIL |
E_POINTER |
E_INVALIDARG |
E_NOTIMPL |
When the time rtBaseTime plus rtStreamTime is reached, the event whose handle is hEvent is set. If the time has already passed, the event is set immediately.
Header: Declared in dmusicc.h.