Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::AssignPChannel

1 つのパフォーマンス チャンネルをパフォーマンスに割り当て、このチャンネルをポート、グループ、MIDI チャンネルにマップする。

オーディオパスを通してデータを渡すアプリケーションでは、このメソッドは使用されない。

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

パラメータ

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

戻り値

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

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

E_INVALIDARG
E_POINTER

注意

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

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

動作環境

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

参照

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