Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::SetNotificationHandle

通知用のイベント ハンドル (Microsoft® Win32® の CreateEvent 関数によって作成される) を設定する。アプリケーションは、このハンドルに対して Win32 WaitForSingleObject 関数を適用すべきである。シグナルが送信されたときに、アプリケーションは IDirectMusicPerformance8::GetNotificationPMsg メソッドを呼び出して、通知イベントを取得すべきである。

HRESULT SetNotificationHandle(
  HANDLE hNotification,
  REFERENCE_TIME rtMinimum
);

パラメータ

hNotification
CreateEvent によって作成されたイベント ハンドル。既存のハンドルを消去する場合は、0 を指定する。
rtMinimum
パフォーマンスが古い通知イベントを破棄するまでに保持しておく最小の時間。値として 0 を指定すると、デフォルトの最小値である 20,000,000 基準タイム単位 (2 秒)、または以前にこのメソッドを呼び出したときの値を意味する。アプリケーションがまだ GetNotificationPMsg を呼び出していない場合は、このイベントは破棄されて、メモリが解放される。

戻り値

S_OK を返す。

注意

通知ハンドルが不要になった場合は、アプリケーションが通知ハンドルに対して Win32 CloseHandle 関数を呼び出さなければならない。

動作環境

  ヘッダー : dmusici.h で宣言。

参照

通知とイベントの処理