Microsoft DirectX 8.0 (C++)

IDirectSoundCapture8::CreateCaptureBuffer

キャプチャ バッファを作成する。

HRESULT CreateCaptureBuffer(
  LPCDSCBUFFERDESC pcDSCBufferDesc, 
  LPDIRECTSOUNDCAPTUREBUFFER * ppDSCBuffer, 
  LPUNKNOWN pUnkOuter 
);

パラメータ

pcDSCBufferDesc
DSCBUFFERDESC 構造体へのポインタ。この構造体は、作成されるキャプチャ バッファ用の値を保持している。
ppDSCBuffer
IDirectSoundCaptureBuffer インターフェイス ポインタを受け取る変数のアドレス。IDirectSoundCaptureBuffer8 を取得するには、QueryInterface を使用する。「注意」を参照すること。
pUnkOuter
COM 集成体に対する制御オブジェクトの IUnknown インターフェイスのアドレス。NULL でなければならない。

戻り値

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

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

DSERR_INVALIDPARAM
DSERR_BADFORMAT
DSERR_GENERIC
DSERR_NODRIVER
DSERR_OUTOFMEMORY
DSERR_UNINITIALIZED

注意

Microsoft® Windows® 95、Windows® 98、および Windows® 2000 では、各キャプチャ デバイスが単一のバッファをサポートする。

IDirectSoundCaptureBuffer8 インターフェイスは、CLSID_DirectSoundCapture8 クラスのオブジェクトで作成されたバッファのみでサポートされる。IDirectSoundCapture8 インターフェイスを DirectSoundCaptureCreate8 から取得した場合は、IDirectSoundCaptureBuffer8 がサポートされる。IDirectSoundCapture8 を以前の DirectSoundCaptureCreate 関数から取得した場合は、IDirectSoundCaptureBuffer だけがサポートされる。

動作環境

  ヘッダー : dsound.h で宣言。