Microsoft DirectX 8.0 (C++)

IDirectMusicSegment8::AddNotificationType

通知タイプを追加する。このメソッドは、セグメントが通知に応答できるようにするために、IDirectMusicPerformance8::AddNotificationType メソッドにより呼び出される。セグメントは各トラックの IDirectMusicTrack8::AddNotificationType メソッドを呼び出す。

HRESULT AddNotificationType(
  REFGUID rguidNotificationType
);

パラメータ

rguidNotificationType
追加される通知タイプの識別子への参照 (C++) またはアドレス (C)。定義済みのタイプについては、「DMUS_NOTIFICATION_PMSG」を参照すること。アプリケーションは、カスタム トラックについて独自のタイプを定義できる。

戻り値

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

バッファの内容は DirectSound によって初期化されない。アプリケーションは、バッファに無音が含まれると想定することはできない。

ハードウェア アクセラレーションを利用できないシステムで DSBCAPS_LOCHARDWARE フラグを使ってバッファを作成しようとすると、メソッドは失敗し、Windows 95 および Windows 98 では DSERR_CONTROLUNAVAIL を返す。Windows 2000 では DSERR_INVALIDCALL を返す。

S_OK を返す。

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

E_POINTER
E_OUTOFMEMORY

注意

セグメントは、タイプ GUID_NOTIFICATION_PERFORMANCE の通知を生成できない。このタイプの通知を取得するには、IDirectMusicPerformance8::AddNotificationType を呼び出さなければならない。

動作環境

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

参照

通知とイベントの処理