Platform SDK: DirectX

IDirectSoundCapture::CreateCaptureBuffer

IDirectSoundCapture::CreateCaptureBuffer メソッドは、キャプチャ バッファを作成する。

出力の目的で複数のサウンドを 1 つのサウンドにミキシングできる DirectSound とは異なり、DirectSoundCapture はその逆、つまり 1 つの入力サウンドから複数のサウンドを抽出することはできない。DirectSoundCapture の最初のバージョンは、1 つのキャプチャ デバイスに対して、どの時点でも 1 つのキャプチャ バッファの存在しか認めていない。

HRESULT CreateCaptureBuffer(
  LPDSCBUFFERDESC lpDSCBufferDesc,  
  LPLPDIRECTSOUNDCAPTUREBUFFER lplpDirectSoundCaptureBuffer,  
  LPUNKNOWN pUnkOuter  
);

パラメータ

lpDSCBufferDesc
DSCBUFFERDESC 構造体へのポインタ。この構造体は、作成されるキャプチャ バッファ用の値を保持している。
lplpDirectSoundCaptureBuffer
成功の場合、IDirectSoundCaptureBuffer インターフェイス ポインタのアドレス。
pUnkOuter
全体の IUnknown のコントロール。この値は NULL でなければならない。

戻り値

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

DSERR_INVALIDPARAM
DSERR_BADFORMAT
DSERR_GENERIC
DSERR_NODRIVER
DSERR_OUTOFMEMORY
DSERR_UNINITIALIZED

動作環境

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