Microsoft DirectX 8.0 (C++) |
16 のパフォーマンス チャンネルから成るブロックをパフォーマンスに割り当て、それらをポートとチャンネル グループにマップする。このメソッドは、オーディオパスを使用しないパフォーマンスに対してのみ有効である。つまり、パフォーマンスは IDirectMusicPerformance8::Init を使用して初期化される。
HRESULT AssignPChannelBlock( DWORD dwBlockNum, IDirectMusicPort* pPort, DWORD dwGroup );
成功した場合は S_OK または S_FALSE を返す (「注意」を参照すること)。
失敗した場合は、次のいずれかのエラー値を返す。
E_INVALIDARG |
E_POINTER |
ポートがパフォーマンスに追加されたときに、このメソッドを呼び出す必要がある。ただし、IDirectMusicPerformance8::AddPort に NULL を渡すことでデフォルト ポートが追加された場合を除く。
dwGroup がポートの範囲外の場合、このメソッドは S_FALSE を返す。チャンネルは割り当てられるが、ポートはそのグループを演奏できない。
dwMChannel が範囲外、または IDirectMusicPerformance8::AddPort メソッドを呼び出してポートをパフォーマンスに追加する作業を行っていない場合、このメソッドは E_INVALIDARG を返す。
ヘッダー : dmusici.h で宣言。
IDirectMusicPerformance8::AssignPChannel、IDirectMusicPerformance8::PChannelInfo、チャンネル