Platform SDK: DirectX

IDirectMusicPerformance::SetNotificationHandle

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

HRESULT SetNotificationHandle(
  HANDLE hNotification,
  REFERENCE_TIME rtMinimum
);

パラメータ

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

戻り値

S_OK を返す。

注意

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

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusici.h で宣言。

参照

通知とイベントの処理