Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::CreateAudioPath

パフォーマンスから DirectSound バッファへのデータ フロー内の各ステージを表す、オーディオパス オブジェクトを作成する。

HRESULT CreateAudioPath(
  IUnknown *pSourceConfig, 
  BOOL fActivate,
  IDirectMusicAudioPath **ppNewPath
);
 

パラメータ

pSourceConfig
オーディオパス構成を表すインターフェイスのアドレス。「注意」を参照すること。
fActivate
作成時にパスをアクティブにするかどうかを指定するブール型の値。
ppNewPath
オーディオパスの IDirectMusicAudioPath8 インターフェイス ポインタを受け取る変数のアドレス。

戻り値

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

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

E_NOINTERFACE
E_POINTER
DMUS_E_NOT_INIT
DMUS_E_AUDIOPATHS_NOT_VALID
DSERR_BUFFERLOST
E_OUTOFMEMORY

注意

pSourceConfig がアドレスするオブジェクトは、IDirectMusicSegment8::GetAudioPathConfig メソッドを使ってセグメントから取得するか、ファイルから直接ロードすることができる。

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

利用できないサウンド デバイスがオーディオパス構成で指定されていると、このメソッドは E_NOINTERFACE を返す。

動作環境

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

参照

オーディオパスの作成