Platform SDK: DirectX

IDirectMusicPerformance::AddPort

IDirectMusicPerformance::AddPort メソッドは、パフォーマンスにポートを割り当てる。

HRESULT AddPort(
  IDirectMusicPort* pPort
);

パラメータ

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

戻り値

成功すれば 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 で宣言。

参照

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