IDirectSoundCaptureBuffer8::GetFXStatus
キャプチャ バッファのエフェクトのステータスを取得する。
HRESULT GetFXStatus(
DWORD dwFXCount,
LPDWORD pdwFXStatus
);
パラメータ
- dwFXCount
- pdwFXStatus 配列の要素数を指定する値。
- pdwFXStatus
- 各エフェクトのステータスを受け取る DWORD 変数の配列のアドレス。このパラメータには、IDirectSoundCapture8::CreateCaptureBuffer の lpDSCFXDesc パラメータで渡される配列と同じ数の要素が含まれる。各エフェクトに対して、次のいずれかのフラグが返される。
- DSCFXR_LOCHARDWARE
- エフェクトはハードウェアでインスタンス化される。
- DSCFXR_LOCSOFTWARE
- エフェクトはソフトウェアでインスタンス化される。
- DSCFXR_UNALLOCATED
- ハードウェアまたはソフトウェアにまだエフェクトが設定されていない。
- DSCFXR_FAILED
- リソースを利用できなかったため、エフェクトは作成されていない。
- DSCFXR_UNKNOWN
- エフェクトがシステムに登録されていないため、エフェクトは作成されていない。
戻り値
成功した場合は DS_OK を返す。
失敗した場合は DSERR_INVALIDPARAM を返す。
ヘッダー : dsound.h で宣言。