Microsoft DirectX 8.0 (C++)

IDirectSoundCaptureBuffer8::GetFXStatus

キャプチャ バッファのエフェクトのステータスを取得する。

HRESULT GetFXStatus(
  DWORD dwFXCount, 
  LPDWORD pdwFXStatus
);

パラメータ

dwFXCount
pdwFXStatus 配列の要素数を指定する値。
pdwFXStatus
各エフェクトのステータスを受け取る DWORD 変数の配列のアドレス。このパラメータには、IDirectSoundCapture8::CreateCaptureBufferlpDSCFXDesc パラメータで渡される配列と同じ数の要素が含まれる。各エフェクトに対して、次のいずれかのフラグが返される。
DSCFXR_LOCHARDWARE
エフェクトはハードウェアでインスタンス化される。
DSCFXR_LOCSOFTWARE
エフェクトはソフトウェアでインスタンス化される。
DSCFXR_UNALLOCATED
ハードウェアまたはソフトウェアにまだエフェクトが設定されていない。
DSCFXR_FAILED
リソースを利用できなかったため、エフェクトは作成されていない。
DSCFXR_UNKNOWN
エフェクトがシステムに登録されていないため、エフェクトは作成されていない。

戻り値

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

失敗した場合は DSERR_INVALIDPARAM を返す。

動作環境

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