| Microsoft DirectX 8.1 (C++) |
The AdvisePeriodic method requests an asynchronous, periodic notification that a duration has elapsed.
Syntax
HRESULT AdvisePeriodic(
REFERENCE_TIME rtStartTime,
REFERENCE_TIME rtPeriodTime,
HANDLE hSemaphore,
DWORD * pdwAdviseCookie
);
Parameters
rtStartTime
Time that the notification should begin.
rtPeriodTime
Period of time between notifications.
hSemaphore
Handle of a semaphore through which to advise.
pdwAdviseCookie
Address of a variable that receives the identifier of the request. This is used to identify this call to AdvisePeriodic 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 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.
Requirements
Header: Declared in dmusicc.h.
See Also