Microsoft DirectX 8.0 (C++)

IDirectSoundCaptureBuffer8::GetObjectInPath

バッファに関連付けられたエフェクト オブジェクトのインターフェイスを取得する。

HRESULT GetObjectInPath(
  REFGUID rguidObject, 
  DWORD dwIndex, 
  REFGUID rguidInterface, 
  LPVOID * ppObject
);

パラメータ

rguidObject
検索するオブジェクトの一意のクラス識別子を指定する REFGUID 型の値。たとえば、GUID_DSCFX_CLASS_AEC など。任意のクラスのオブジェクトを検索する場合は、このパラメータを GUID_All_Objects に設定する。
dwIndex
パス中のクラスのオブジェクト内で、オブジェクトのインデックスを指定する値。「注意」を参照すること。
rguidInterface
目的のインターフェイスの一意の識別子を指定する値。たとえば、IID_IDirectSoundCaptureFXAec8 など。
ppObject
目的のインターフェイス ポインタを受け取る変数のアドレス。

戻り値

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

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

DSERR_CONTROLUNAVAIL
DSERR_INVALIDPARAM
E_NOINTERFACE

注意

dwIndex の値は、IDirectSoundCapture8::CreateCaptureBuffer に渡されたエフェクトの配列内でのオブジェクトのインデックスである。いくつかのエフェクトがまだ作成されていない場合があるため、エフェクト内の実際のオブジェクトの位置を表しているとは限らない。

オブジェクトは、rguidObject および dwIndex との一致だけに基づいて返される。rguidInterface がそのオブジェクトで使用されているインターフェイスを示しているかどうかは、アプリケーション側で確認する必要がある。

動作環境

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