IDirectMusicPerformance

IDirectMusicPerformance8::CreateStandardAudioPath

DirectMusic パフォーマンスから DirectSound バッファへのデータフロー内の各ステージを表す、標準オーディオパスオブジェクトを作成し、作成されたオーディオパスの IDirectMusicAudioPath インターフェイスポインタを取得します。

HRESULT CreateStandardAudioPath(
    DWORD  dwType,
    DWORD  dwPChannelCount,
    BOOL   fActivate,
    IDirectMusicAudioPath**  ppNewPath
);

メソッドのインデックス： 49

パラメータ

dwType

作成するオーディオパスのタイプを指定します。以下の値のいずれかを指定します。

値 機能
1 (DMUS_APATH_SHARED_STEREOPLUSREVERB) ステレオ出力とリバーブを備えた、通常のミュージックセットアップ
6 (DMUS_APATH_DYNAMIC_3D) 3D バッファに対する1つのバス
7 (DMUS_APATH_DYNAMIC_MONO) モノラルバッファに対する1つのバス
8 (DMUS_APATH_DYNAMIC_STEREO) ステレオバッファに対する2つのバス
dwPChannelCount

オーディオパスに割り当てるパフォーマンスチャンネル数を指定します。

fActivate

作成時にパスをアクティブにするかどうかを指定します。 1 (TRUE) を指定すると、作成時にパスをアクティブにします。 0 (FALSE) を指定すると、アクティブにしません。

pParams

シンセサイザのパラメータを指定し、どのパラメータが設定されたかについての情報を受け取る DMUS_AUDIOPARAMS 構造体のアドレスを指定します。 0 (NULL) を指定すると、デフォルトのパラメータが使用されます。

ppNewPath

作成されたオーディオパスの IDirectMusicAudioPath インターフェイスポインタを受け取る変数のアドレスを指定します。

戻り値

成功すると 0x00000000 (S_OK) が返ります。

失敗すると以下のいずれかのエラー値が返ります。

値 意味
0x80004003 (E_POINTER)

無効なポインタが渡されました。
0x8007000E (E_OUTOFMEMORY)

メモリ不足のため完了できませんでした。
0x80070057 (E_INVALIDARG)

無効な引数が渡されました。
0x88781151 (DMUS_E_ALREADY_INITED)

オブジェクトは既に初期化されています。
0x88781162 (DMUS_E_NOT_INIT)

必要なオブジェクトは初期化されていません。

0x88781226 (DMUS_E_AUDIOPATHS_NOT_VALID)

パフォーマンスチャンネルが IDirectMusicPerformance8::AssignPChannel を使ってセットアップされたので、パフォーマンスはオーディオパスをサポートできません。
0x88780096 (DSERR_BUFFERLOST)

バッファメモリが失われたため、復元しなければなりません。