Microsoft DirectX 8.0 (C++)

DSCBUFFERDESC

キャプチャ バッファを記述する。IDirectSoundCapture8::CreateCaptureBuffer メソッドで使われる。

DirectX 7 以前との互換性を保つために、この構造体の前のバージョンの DSCBUFFERDESC1 も dsound.h で維持されている。

typedef struct {
    DWORD           dwSize;
    DWORD           dwFlags;
    DWORD           dwBufferBytes;
    DWORD           dwReserved;
    LPWAVEFORMATEX  lpwfxFormat;
    DWORD           dwFXCount;
    LPDSCEFFECTDESC lpDSCFXDesc;
} DSCBUFFERDESC, *LPDSCBUFFERDESC;
 
typedef const DSCBUFFERDESC *LPCDSCBUFFERDESC;

メンバ

dwSize
構造体のサイズ (バイト単位)。この構造体を使う前に、このメンバを初期化しなければならない。
dwFlags
デバイスの能力を指定する。0 か、次のフラグの 1 つまたは複数を指定できる。
DSCBCAPS_CTRLFX
バッファはエフェクトをサポートする。「注意」を参照すること。
DSCBCAPS_WAVEMAPPED
このデバイスがサポートしないフォーマットに対して、Win32 ウェーブ マッパーを使う。
dwBufferBytes
作成されるキャプチャ バッファのサイズ (バイト単位)。
dwReserved
将来の使用に備えて予約されている。
lpwfxFormat
データのキャプチャに使うフォーマットを保持する WAVEFORMATEX 構造体へのポインタ。
dwFXCount
lpDSCFXDesc で示される配列の要素数。dwFlags が DSCBCAPS_CTRLFX でない場合は、0 でなければならない。
lpDSCFXDesc
DSCEFFECTDESC 構造体の配列のアドレス。バッファに対してハードウェアでサポートされているエフェクトを記述する。ユーザー モードの DMO はサポートされない。

注意

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

現在のオペレーティング システムでは、キャプチャ エフェクトはサポートされない。

動作環境

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