Platform SDK: DirectX

IDirectMusicGraph::InsertTool

IDirectMusicGraph::InsertTool メソッドは、グラフにツールを挿入する。

HRESULT InsertTool(
  IDirectMusicTool * pTool,
  DWORD * pdwPChannels,
  DWORD cPChannels,
  LONG lIndex
);

パラメータ

pTool
挿入するツール。
pdwPChannels
ツールがメッセージを受け取る P チャンネルの配列のアドレス。このツールがあらゆる P チャンネルでメッセージを受け取る場合、NULL を渡す。
cPChannels
pdwPChannels が指す P チャンネルの数。pdwPChannels が NULL の場合は無視される。
lIndex
ツールを置く位置。これは 0 から始まるインデックスであり、現在のツールリストの先頭または最後 (値が負の場合 ) から数えた位置を意味する。lIndex が範囲外の場合、ツールはリストの先頭または最後に置かれる。ツールをリストの最後に置くには、現在のツールリスト内のツール数より大きい値を lIndex で指定する。

戻り値

成功すれば S_OK を返す。

失敗すれば次のエラー値のいずれかを返す。

DMUS_E_ALREADY_EXISTS
E_OUTOFMEMORY
E_POINTER

注意

ツールの参照カウントはインクリメントされる。

このメソッドは IDirectMusicTool::Init を呼び出す。

動作環境

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