Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::CreateStandardAudioPath

パフォーマンスから DirectSound バッファへのデータ フロー内の各ステージを表す、オブジェクトを作成する。このメソッドを使用すると、IDirectMusicPerformance8::CreateAudioPath でソース ファイルに定義されたオーディオパスを作成する代わりに、基本的な事前定義オーディオパスを作成することができる。

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

パラメータ

dwType
パスのタイプ。次の値が定義されている。
DMUS_APATH_DYNAMIC_3D
3D バッファに対する 1 つのバス。環境リバーブには送らない。
DMUS_APATH_DYNAMIC_MONO
モノラル バッファに対する 1 つのバス。
DMUS_APATH_SHARED_STEREOPLUSREVERB
ステレオ出力とリバーブを備えた、通常のミュージック セットアップ。
DMUS_APATH_DYNAMIC_STEREO
ステレオ バッファに対する 2 つのバス。

これらのオーディオパスの詳細については、「標準オーディオパス」を参照すること。

dwPChannelCount
パス内のパフォーマンス チャンネルの数。
fActivate
作成時にパスをアクティブにするかどうかを指定するブール型の値。
ppNewPath
オーディオパスの IDirectMusicAudioPath インターフェイス ポインタを受け取る変数のアドレス。「IDirectMusicAudioPath8」を参照すること。

戻り値

成功した場合は S_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

E_POINTER
DMUS_E_NOT_INIT
DMUS_E_AUDIOPATHS_NOT_VALID
DSERR_BUFFERLOST
E_INVALIDARG
E_OUTOFMEMORY

注意

DirectSound が何かのアプリケーションによって書き込み優先協調レベルで初期化されていると、このメソッドは失敗して DSERR_BUFFERLOST を返す。

動作環境

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