Microsoft DirectX 8.0 (C++)

DMUS_PORTPARAMS8

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

DMUS_PORTPARAMS という定義は DMUS_PORTPARAMS8 に解決される。この構造体は、DMUS_PORTPARAMS 以前のバージョンを引き継ぐ。以前のバージョンは現在 DMUS_PORTPARAMS7 として宣言される。

typedef struct _DMUS_PORTPARAMS8 {
    DWORD dwSize;
    DWORD dwValidParams;
    DWORD dwVoices;
    DWORD dwChannelGroups;
    DWORD dwAudioChannels;
    DWORD dwSampleRate;
    DWORD dwEffectFlags;
    DWORD fShare;
    DWORD dwFeatures;
} DMUS_PORTPARAMS8;
 
typedef DMUS_PORTPARAMS8 DMUS_PORTPARAMS;
typedef 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
DMUS_PORTPARAMS_FEATURES
dwVoices
このポートで必要なボイスの数。これは絶対的な最大値ではない。ポートは、優先順位の低いボイスを削除する必要があるときに、追加のボイスを一時的に作成し、スムーズにトランジションさせることができる。
dwChannelGroups
このポートに割り当てられるチャンネル グループの数。IDirectMusic8::EnumPort メソッドと IDirectMusicPort8::GetCaps メソッドが返した DMUS_PORTCAPS 構造体で指定されるチャンネル グループ数以下でなければならない。
dwAudioChannels
目的の出力チャンネル数。
dwSampleRate
目的のサンプリング レート。ヘルツ (Hz) 単位で指定する。
dwEffectFlags
目的の特殊効果を示すフラグ。次のフラグが定義されている。

DMUS_EFFECT_NONE
DMUS_EFFECT_REVERB
DMUS_EFFECT_CHORUS

fShare
TRUE の場合、すべてのポートが、このポートに割り当てられたチャンネル グループを使用する。FALSE の場合、ポートは排他モードで開かれ、その他のポートによる同じチャンネル グループの使用が禁止される。
dwFeatures
ポートのその他の能力。次の値が定義されている。
DMUS_PORT_FEATURE_AUDIOPATH
DirectSound バッファとのオーディオパス接続をサポートする。
DMUS_PORT_FEATURE_STREAMING
シンセサイザからのストリーミング ウェーブをサポートする。

注意

DirectX 8.0 より前のバージョンの DMUS_PORTPARAMS 構造体は、DMUS_PORTPARAMS7 として Dmusicc.h 内に維持される。

動作環境

  ヘッダー : dmusicc.h で宣言。

参照

DMUS_PORTCAPS