Platform SDK: DirectX |
IDirectMusicPerformance::AssignPChannelBlock メソッドは、16 のパフォーマンス チャンネル (P チャンネル) から成るグループをパフォーマンスに割り当て、それらをポートとチャンネル グループにマップする。ポートをパフォーマンスに追加したときは、このメソッドを呼び出さなければならない。ただし、IDirectMusicPerformance::AddPort に NULL を渡すことによってデフォルト ポートを追加した場合を除く。
HRESULT AssignPChannelBlock( DWORD dwBlockNum, IDirectMusicPort* pPort, DWORD dwGroup );
成功すれば 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::AssignPChannel、IDirectMusicPerformance::PChannelInfo、チャンネル