Platform SDK: DirectX |
IDirectMusicPerformance::AssignPChannel メソッドは、1 つのパフォーマンス チャンネル (P チャンネル) をパフォーマンスに割り当て、このチャンネルをポート、グループ、MIDI チャンネルにマップする。
HRESULT AssignPChannel( DWORD dwPChannel, IDirectMusicPort* pPort, DWORD dwGroup, DWORD dwMChannel );
成功すれば 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::AssignPChannelBlock、IDirectMusicPerformance::PChannelInfo、チャンネル