Platform SDK: DirectX |
The IReferenceClock::AdvisePeriodic method requests an asynchronous, periodic notification that a duration has elapsed.
HRESULT AdvisePeriodic( REFERENCE_TIME rtStartTime, REFERENCE_TIME rtPeriodTime, HSEMAPHORE hSemaphore, 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 indicated by rtStartTime is reached, the semaphore whose handle is set as hSemaphore is released. Thereafter, the semaphore is released repetitively with a period of rtPeriodTime.
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.