Platform SDK: DirectX |
IDirectMusicPerformance::AddPort メソッドは、パフォーマンスにポートを割り当てる。
HRESULT AddPort( IDirectMusicPort* pPort );
成功すれば S_OK を返す。
失敗すれば次のエラー値のいずれかを返す。
DMUS_E_NOT_INIT |
DMUS_E_CANNOT_OPEN_PORT |
E_OUTOFMEMORY |
E_POINTER |
このメソッドに NULL を渡したい場合は、最初にIDirectMusicPerformance::Init に NULL を渡す必要がある。
pPort に NULL を渡してデフォルト ポートが指定された場合、このデフォルト ポートには 1 つのチャンネル グループが割り当てられる。その他のポートについて P チャンネル が設定されていない場合、0 〜 15 の P チャンネルが、0 〜 15 の MIDI チャンネルに割り当てられる。
pPort が NULL でない場合、IDirectMusicPort::Activate の呼び出しによってポートをアクティブ化し、IDirectMusicPerformance::AssignPChannelBlock の呼び出しによってチャンネル ブロックを割り当てなければならない。
このメソッドは、IDirectMusicPerformance::RemovePort または IDirectMusicPerformance::CloseDown によって解放される IDirectMusicPort への参照を作成する。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dmusici.h で宣言。