Platform SDK: DirectX

DMUS_PORTPARAMS

DMUS_PORTPARAMS 構造体は、DirectMusic ポートを開くためのパラメータによって構成されている。IDirectMusic::CreatePort メソッドを呼び出したときに、これらのパラメータが渡される。

typedef struct _DMUS_PORTPARAMS {
    DWORD dwSize;
    DWORD dwValidParams;
    DWORD dwVoices;
    DWORD dwChannelGroups;
    DWORD dwAudioChannels;
    DWORD dwSampleRate;
    DWORD dwEffectFlags;
    DWORD fShare;
} DMUS_PORTPARAMS, *LPDMUS_PORTPARAMS;

メンバ

dwSize
構造体のサイズ。バイト単位で指定する。この構造体を任意のメソッドに渡す前に、このメンバを sizeof(DMUS_PORTPARAMS) に初期化しなければならない。
dwValidParams
この構造体内のどのポート パラメータへの書き込みが行われているかを指定する。特定のパラメータにフラグをセットすることは、ポートの作成時に、メソッドの呼び出しでそのパラメータを設定したい、またはデフォルト値を上書きしたいことを意味する。次のフラグが定義されている。

DMUS_PORTPARAMS_VOICES
DMUS_PORTPARAMS_CHANNELGROUPS
DMUS_PORTPARAMS_AUDIOCHANNELS
DMUS_PORTPARAMS_SAMPLERATE
DMUS_PORTPARAMS_EFFECTS
DMUS_PORTPARAMS_SHARE

dwVoices
このポートで必要な発音の数。これは絶対的な最大値ではない。ポートは、優先順位の低い発音を削除する必要があるときに、追加の発音を一時的に作成し、スムーズに変化させることができる。
dwChannelGroups
このポートに割り当てられるチャンネル グループの数。IDirectMusic::EnumPortIDirectMusicPort::GetCaps の各メソッドが返した DMUS_PORTCAPS 構造体で指定されるチャンネル グループ数以下でなければならない。
dwAudioChannels
希望の出力チャンネル数。
dwSampleRate
希望のサンプリング レート。ヘルツ (Hz) 単位で指定する。
dwEffectFlags
希望の特殊効果を示すフラグ。次のフラグが定義されている。

DMUS_EFFECT_NONE
DMUS_EFFECT_REVERB
DMUS_EFFECT_CHORUS

fShare
TRUE の場合、すべてのポートが、このポートに割り当てられたチャンネル グループを使う。FALSE の場合、ポートは排他モードで開かれ、その他のポートによる同じチャンネル グループの使用が禁止される。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusicc.h で宣言。

参照

DMUS_PORTCAPS