Microsoft DirectX 8.0 (C++) |
サンプリング オーディオのシーケンスを保持するための DirectSoundBuffer オブジェクトを作成する。
HRESULT CreateSoundBuffer( LPCDSBUFFERDESC pcDSBufferDesc, LPDIRECTSOUNDBUFFER * ppDSBuffer, LPUNKNOWN pUnkOuter );
成功した場合は DS_OK を返す。また、要求した 3D アルゴリズムを利用できず、ステレオ パンが代用された場合は、DS_NO_VIRTUALIZATION を返す。DSBUFFERDESC の guid3DAlgorithm メンバの記述を参照すること。
失敗した場合は、次のいずれかのエラー値を返す。
DirectSound は、バッファの内容を初期化しない。したがって、アプリケーションでは、バッファに無音が含まれていると想定してはならない。
アプリケーションがマルチスレッド化されている場合、バッファを作成するスレッドは、バッファの有効期間を通して存在していなければならない。WDM ドライバで作成されたバッファでは、スレッドが終了すると再生が停止する。
ハードウェア アクセラレーションを利用できないシステムで DSBCAPS_LOCHARDWARE フラグを使ってバッファを作成しようとすると、メソッドは失敗し、オペレーティング システムに応じて DSERR_CONTROLUNAVAIL または DSERR_INVALIDCALL を返す。
ヘッダー : dsound.h で宣言。