Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::AddPort

パフォーマンスにポートを割り当てる。このメソッドは、オーディオパスを使用しないパフォーマンスに対してのみ有効である。つまり、パフォーマンスは IDirectMusicPerformance8::Init を使用して初期化される。

HRESULT AddPort(
  IDirectMusicPort* pPort
);

パラメータ

pPort
追加するポートを含む変数のアドレス。NULL の場合はデフォルト ポートが追加される。「注意」を参照すること。

戻り値

成功した場合は 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 で宣言。

参照

IDirectMusicPerformance8::RemovePortデフォルト ポート