Platform SDK: DirectX

DirectMusicPerformance.SetPort

DirectMusicPerformance.SetPort メソッドは、パフォーマンスのアクティブ ポートを設定する。このメソッドは、パフォーマンスを初期化した後、および任意の音色をダウンロードまたは任意のセグメントを演奏する前に呼び出さなければならない。

object.SetPort(index As Long, numGroups As Long)

パラメータ

object
DirectMusicPerformance オブジェクトを表すオブジェクト式。
index
ポートのインデックス。1 〜 DirectMusicPerformance.GetPortCount が返す値の範囲で指定しなければならない。デフォルト ポートの場合は -1 を指定する。
numGroups
ポート上のチャンネル グループの数。lMaxChannelGroups メンバで報告されるチャンネル グループの数以下でなければならない。このメンバは、DirectMusicPerformance.GetPortCaps メソッドによって返される DMUS_PORTCAPS 型のメンバである。

注意

各チャンネル グループは 16 個のチャンネルで構成される。十分な数のチャンネル グループを割り当て、演奏するセグメント内にすべてのパフォーマンス チャンネルが収まるようにする。MIDI ファイルの場合は、1 つのチャンネル グループで十分である。Microsoft Software Synthesizer は、最大 1,000 個までのチャンネル グループをサポートする。