Microsoft DirectX 8.0 (C++)

IDirectMusicGraph8::InsertTool

グラフにツールを挿入する。

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

パラメータ

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

戻り値

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

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

DMUS_E_ALREADY_EXISTS
E_OUTOFMEMORY
E_POINTER

注意

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

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

動作環境

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