Microsoft DirectX 8.0 (C++)

IDirectMusicPort8::SetReadNotificationHandle

IDirectMusicPort8::Read メソッドを使って MIDI メッセージが読み込めるようになったときに設定されるイベントを指定する。新しいデータが利用可能になると、必ずイベントのシグナルが送信される。イベント通知を無効にするには、hEvent パラメータの値として NULL を指定し、SetReadNotificationHandle を呼び出す。

HRESULT SetReadNotificationHandle(
  HANDLE hEvent
);

パラメータ

hEvent
Win32 CreateEvent 関数を呼び出したときに取得したイベント ハンドル。ポートが解放されたら、アプリケーションがこのハンドルを閉じなければならない。

戻り値

成功した場合は S_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

DMUS_E_DMUSIC_RELEASED
E_NOTIMPL

注意

E_NOTIMPL は、そのポートが入力ポートでないことを意味する戻り値を返す場合もある。

動作環境

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

参照

MIDI のキャプチャ