CBaseReferenceClock::AdvisePeriodic

AdvisePeriodic メソッドは、周期的アドバイズ要求を作成する。このメソッドは IReferenceClock::AdvisePeriodic メソッドを実装する。

構文

  HRESULT AdvisePeriodic(
    REFERENCE_TIME StartTime,
    REFERENCE_TIME PeriodTime,
    HSEMAPHORE hSemaphore,
    DWORD *pdwAdviseToken
);

パラメータ

StartTime

最初の通知のタイム (100 ナノ秒単位)。0 より大きく、かつ MAX_TIME より小さくなければならない。

PeriodTime

通知の間隔 (100 ナノ秒単位)。0 より大きくなければならない。

hSemaphore

セマフォのハンドル。呼び出し元によって作成される。

pdwAdviseToken

アドバイズ要求の識別子を受け取る変数へのポインタ。

戻り値

次の表に示す、いずれかの HRESULT 値を返す。

値	説明
S_OK	成功
E_INVALIDARG	無効なタイム値
E_OUTOFMEMORY	失敗
E_POINTER	NULL ポインタ引数

注意

クロックは、通知のたびに hSemaphore パラメータで指定されたセマフォを解放する。以降の通知が必要でない場合は、CBaseReferenceClock::Unadvise メソッドを呼び出し、この呼び出しから返された pdwAdviseToken 値を渡す。

参照

• CBaseReferenceClock クラス