Platform SDK: DirectX

DirectSoundCaptureCreate

DirectSoundCaptureCreate 関数は、IDirectSoundCapture インターフェイスをサポートするオブジェクトの作成と初期化を行う。

HRESULT WINAPI DirectSoundCaptureCreate(
  LPCGUID lpcGUID,                 
  LPDIRECTSOUNDCAPTURE *lplpDSC,  
  LPUNKNOWN pUnkOuter             
);

パラメータ

lpcGUID
サウンド キャプチャ デバイスを識別する GUID のアドレス。このパラメータの値は、DirectSoundCaptureEnumerate が返した GUID のいずれか、またはデフォルトのデバイスを指定する NULL でなければならない。
lplpDSC
この関数が作成した DirectSoundCapture オブジェクトへのポインタのアドレス。
pUnkOuter
全体の未定義のコントロール。この値は NULL でなければならない。

戻り値

成功すれば DS_OK、失敗すれば次のエラー値のいずれかを返す。

DSERR_ALLOCATED
DSERR_INVALIDPARAM
DSERR_NOAGGREGATION
DSERR_OUTOFMEMORY

注意

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

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dsound.h で宣言。
  インポート ライブラリ : dsound.lib を使用。