Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::AssignPChannelBlock

16 のパフォーマンス チャンネルから成るブロックをパフォーマンスに割り当て、それらをポートとチャンネル グループにマップする。このメソッドは、オーディオパスを使用しないパフォーマンスに対してのみ有効である。つまり、パフォーマンスは IDirectMusicPerformance8::Init を使用して初期化される。

HRESULT AssignPChannelBlock(
  DWORD dwBlockNum,
  IDirectMusicPort* pPort,
  DWORD dwGroup
);

パラメータ

dwBlockNum
ブロック番号。0 はチャンネル 0 〜 15、1 はチャンネル 16 〜 31 を表す。以下同様である。
pPort
チャンネルの割り当て先のポートを含む変数のアドレス。
dwGroup
ポート上のチャンネル グループ。1 以上の値でなければならない。

戻り値

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

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

E_INVALIDARG
E_POINTER

注意

ポートがパフォーマンスに追加されたときに、このメソッドを呼び出す必要がある。ただし、IDirectMusicPerformance8::AddPort に NULL を渡すことでデフォルト ポートが追加された場合を除く。

dwGroup がポートの範囲外の場合、このメソッドは S_FALSE を返す。チャンネルは割り当てられるが、ポートはそのグループを演奏できない。

dwMChannel が範囲外、または IDirectMusicPerformance8::AddPort メソッドを呼び出してポートをパフォーマンスに追加する作業を行っていない場合、このメソッドは E_INVALIDARG を返す。

動作環境

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

参照

IDirectMusicPerformance8::AssignPChannelIDirectMusicPerformance8::PChannelInfoチャンネル