| Microsoft DirectX 8.1 (C++) |
The AdviseTime method requests an asynchronous notification that a time has elapsed.
Syntax
HRESULT AdviseTime(
REFERENCE_TIME rtBaseTime,
REFERENCE_TIME rtStreamTime,
HANDLE hEvent,
DWORD * pdwAdviseCookie
);
Parameters
rtBaseTime
Base reference time.
rtStreamTime
Stream offset time.
hEvent
Handle to an event through which to advise.
pdwAdviseCookie
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
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.
| Return code |
| E_FAIL |
| E_POINTER |
| E_INVALIDARG |
| E_NOTIMPL |
Remarks
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.
Requirements
Header: Declared in dmusicc.h.
See Also