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