Microsoft DirectX 8.0 (C++)

DirectSoundCaptureCreate8

IDirectSoundCapture8 インターフェイスをサポートするオブジェクトを作成および初期化する。

この関数は、キャプチャ エフェクトをサポートするオブジェクトを作成する。以前の DirectSoundCaptureCreate 関数を使って IDirectSoundCapture8 インターフェイスを取得することもできるが、この場合、作成されたオブジェクトは IDirectSoundCaptureBuffer8 インターフェイスをサポートするキャプチャ バッファを作成するために利用できない。

HRESULT WINAPI DirectSoundCaptureCreate8(
  LPCGUID lpcGUID,
  LPDIRECTSOUNDCAPTURE8 *lplpDSC,
  LPUNKNOWN pUnkOuter
);

パラメータ

lpcGUID
サウンド キャプチャ デバイスを識別する GUID のアドレス。このパラメータの値は、DirectSoundCaptureEnumerate が返した GUID のいずれか、デフォルトのデバイスを指定する NULL、または次のいずれかの値でなければならない。
DSDEVID_DefaultCapture
システムワイドなデフォルトのオーディオ キャプチャ デバイス。
DSDEVID_DefaultVoiceCapture
デフォルトの音声キャプチャ デバイス。
lplpDSC
IDirectSoundCapture8 インターフェイス ポインタを受け取る変数のアドレス。
pUnkOuter
COM 集成体に対する制御オブジェクトの IUnknown インターフェイスのアドレス。集成体はサポートされていないため、NULL に設定しなければならない。

戻り値

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

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

DSERR_ALLOCATED
DSERR_INVALIDPARAM
DSERR_NOAGGREGATION
DSERR_OUTOFMEMORY

注意

全二重をサポートしないサウンド カードでは、このメソッドは失敗し、DSERR_ALLOCATED を返す。

動作環境

  ヘッダー : dsound.h で宣言。
  インポート ライブラリ : dsound.lib を使用。