Platform SDK: DirectX

IDirectMusicPerformance::AssignPChannel

IDirectMusicPerformance::AssignPChannel メソッドは、1 つのパフォーマンス チャンネル (P チャンネル) をパフォーマンスに割り当て、このチャンネルをポート、グループ、MIDI チャンネルにマップする。

HRESULT AssignPChannel(
  DWORD dwPChannel, 
  IDirectMusicPort* pPort,
  DWORD dwGroup, 
  DWORD dwMChannel
);

パラメータ

dwPChannel
割り当てられる P チャンネル。
pPort
P チャンネルの割り当て先のポートを含む変数のアドレス。
dwGroup
ポート上のチャンネル グループ。
dwMChannel
グループ内のチャンネル。0 〜 15 の範囲でなければならない。

戻り値

成功すれば 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::AssignPChannelBlockIDirectMusicPerformance::PChannelInfoチャンネル