Platform SDK: DirectX

IDirectMusicPerformance::RemoveNotificationType

IDirectMusicPerformance::RemoveNotificationType メソッドは、以前に通知された通知タイプをパフォーマンスから削除する。RemoveNotificationType メソッドを呼び出すと、すべてのセグメントとトラックは更新される。

HRESULT RemoveNotificationType(
  REFGUID rguidNotificationType
);

パラメータ

rguidNotificationType
削除される通知タイプの識別子への参照 (C++) またはアドレス (C) (定義済みのタイプについては、「DMUS_NOTIFICATION_PMSG」を参照すること)。この値が GUID_NULL の場合、すべての通知が削除される。

戻り値

成功すれば S_OK または S_FALSE (「注意」を参照すること) を返す。

失敗すれば E_POINTER を返す。

注意

rguidNotificationType がアクティブな通知ではない場合、S_FALSE が返される。

演奏を停止したセグメントに通知を追加した場合、セグメントへの参照が失われることにより、パフォーマンスはそのセグメントから通知タイプを削除できなくなる。

動作環境

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

参照

IDirectMusicPerformance::AddNotificationTypeIDirectMusicSegment::RemoveNotificationTypeIDirectMusicTrack::RemoveNotificationType通知とイベントの処理