Microsoft DirectX 8.0 (C++) |
パフォーマンスにポートを割り当てる。このメソッドは、オーディオパスを使用しないパフォーマンスに対してのみ有効である。つまり、パフォーマンスは IDirectMusicPerformance8::Init を使用して初期化される。
HRESULT AddPort( IDirectMusicPort* pPort );
成功した場合は S_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
DMUS_E_NOT_INIT |
DMUS_E_CANNOT_OPEN_PORT |
E_OUTOFMEMORY |
E_POINTER |
pPort に NULL を渡してデフォルト ポートが指定された場合、このデフォルト ポートには 1 つのチャンネル グループが割り当てられる。その他のポートについてパフォーマンス チャンネルが設定されていない場合、0 〜 15 のチャンネルが、0 〜 15 の MIDI チャンネルに割り当てられる。
pPort が NULL でない場合、ポートはそのポートが渡されたのと同じ DirectMusic オブジェクトによって作成されるか、または IDirectMusicPerformance8::Init によって作成される必要がある。 IDirectMusicPort8::Activate を呼び出してポートをアクティブにし、IDirectMusicPerformance8::AssignPChannelBlock を呼び出してチャンネル ブロックを割り当てなければならない。
このメソッドは、IDirectMusicPort8 への参照を作成する。この参照は、IDirectMusicPerformance8::RemovePort または IDirectMusicPerformance8::CloseDown によって解放される。ただし、AddPort に NULL が渡される場合、アプリケーションには RemovePort に渡す参照がないため、RemovePort でポートを削除することはできない。
ヘッダー : dmusici.h で宣言。