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