DirectSoundCaptureCreate8

  • [アーティクル]

DirectSoundCaptureCreate8 関数は、IDirectSoundCapture8 インターフェイスをサポートするオブジェクトを作成し、初期化します。これまでの DirectSoundCaptureCreate 関数は、IDirectSoundCapture8 インターフェイスの取得にも使用できましたが、この関数を使って作成したオブジェクトで、IDirectSoundCaptureBuffer8 インターフェイスをサポートするキャプチャー バッファーを作成することはできません。

HRESULT 
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 内容

関連項目

キャプチャー デバイス オブジェクトの作成