Platform SDK: DirectX

IDirectMusicPerformance::AssignPChannelBlock

IDirectMusicPerformance::AssignPChannelBlock メソッドは、16 のパフォーマンス チャンネル (P チャンネル) から成るグループをパフォーマンスに割り当て、それらをポートとチャンネル グループにマップする。ポートをパフォーマンスに追加したときは、このメソッドを呼び出さなければならない。ただし、IDirectMusicPerformance::AddPort に NULL を渡すことによってデフォルト ポートを追加した場合を除く。

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

注意

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

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

動作環境

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

参照

IDirectMusicPerformance::AssignPChannelIDirectMusicPerformance::PChannelInfoチャンネル