Microsoft DirectX 8.0 (Visual Basic)

DirectSoundSecondaryBuffer8.GetObjectInPath

バッファのオーディオ パス内のオブジェクトを取得する。このメソッドは一般的に、バッファまたは DMO のサウンド エフェクトを表すオブジェクトを取得するために使う。

object.GetObjectinPath( _
  guidFX As String, _
  lIndex As Long, _
  iidInterface As String _
) As Unknown

指定項目

object
DirectSoundSecondaryBuffer8 オブジェクトを指定する。
guidFX
エフェクト クラスのユニーク識別子を指定する文字列。「注意」を参照すること。DSFX で始まる AUDIOSTRINGCONSTANTS モジュールのメンバのいずれか、または文字列形式の GUID を指定する。「注意」を参照すること。
lIndex
パス中のクラスのオブジェクト内で、オブジェクトのインデックスを指定する Long 型の値。DirectSoundSecondaryBuffer8.SetFX に渡されるエフェクトの配列における、オブジェクトのインデックスである。いくつかのエフェクトがまだ作成されていない場合があるため、エフェクト チェーンにおける実際のオブジェクトの位置を表しているとは限らない。
iidInterface
返されたオブジェクトのクラスの一意な識別子を指定する String 値。ID で始まる AUDIOSTRINGCONSTANTS モジュールのメンバのいずれか、または文字列形式の GUID を指定する。「注意」を参照すること。

戻り値

エフェクトを表すオブジェクトを返す。

エラー コード

失敗した場合はエラーが発生する。Err.Number に設定される値には、DSERR_OBJECTNOTFOUND が含まれる。

注意

次の表は、エフェクトが設定されたバッファから取得できる、標準的なエフェクト オブジェクトを示している。

guidFX iidInterface 返されるオブジェクト
DSFX_STANDARD_CHORUS IID_DirectSoundFXChorus DirectSoundFXChorus8
DSFX_STANDARD_COMPRESSOR IID_DirectSoundFXCompressor DirectSoundFXCompressor8
DSFX_STANDARD_DISTORTION IID_DirectSoundFXDistortion DirectSoundFXDistortion8
DSFX_STANDARD_ECHO IID_DirectSoundFXEcho DirectSoundFXEcho8
DSFX_STANDARD_FLANGER IID_DirectSoundFXFlanger DirectSoundFXFlanger8
DSFX_STANDARD_GARGLE IID_DirectSoundFXGargle DirectSoundFXGargle8
DSFX_STANDARD_I3DL2REVERB IID_DirectSoundFXI3DL2REVERB DirectSoundFXI3DL2Reverb8
DSFX_STANDARD_PARAMEQ IID_DirectSoundFXParamEq DirectSoundFXParamEq8
DSFX_STANDARD_WAVES_REVERB IID_DirectSoundFXWavesReverb DirectSoundFXWavesReverb8

DirectSoundSecondaryBuffer8.SetFX を使用してバッファに設定されたDMO はすべて、リソースが割り当てられていない場合でも取得できる。

参照

DirectSoundSecondaryBuffer8.SetFXGUID の使い方