IDirectSoundBuffer8 インターフェイス
IDirectSoundBuffer8 インターフェイスは、サウンド バッファを管理するために使う。
IDirectSoundBuffer に代わって IDirectSoundBuffer8 インターフェイスが提供され、新しいメソッドが追加されている。
このインターフェイスを取得するには、IDirectSound8::CreateSoundBuffer メソッドを使って IDirectSoundBuffer を取得し、IID_IDirectSoundBuffer8 を IDirectSoundBuffer::QueryInterface に渡す。
プライマリ バッファの場合は、IDirectSoundBuffer インターフェイスを使う必要がある。IDirectSoundBuffer8 は利用できない。IDirectSoundBuffer の独立した説明項目はない。説明は、対応する IDirectSoundBuffer8 メソッドを参照すること。
IDirectSoundBuffer のすべてのメソッドが、プライマリ バッファに対して有効であるわけではない。たとえば、SetCurrentPosition は失敗する。各メソッドについては、リファレンスのトピックを参照すること。
IUnknown から継承するメソッドのほかに、IDirectSoundBuffer8 インターフェイスでは、カテゴリ別に示す以下のメソッドが公開されている。
エフェクト
| メソッド | 説明 |
| GetObjectInPath | バッファに関連付けられたエフェクト オブジェクトのインターフェイスを取得する。 |
| SetFX | バッファのエフェクトを有効にする。 |
リソース管理
| メソッド | 説明 |
| AcquireResources | DSBCAPS_LOCDEFER フラグで作成されたバッファにリソースを割り当てる。 |
| Restore | 失われたサウンド バッファへのメモリ割り当てを復元する。 |
再生管理
| メソッド | 説明 |
| GetCurrentPosition | サウンド バッファの再生カーソルと書き込みカーソルの位置を取得する。 |
| Lock | バッファの全部または一部をデータ書き込み用に準備し、データを書き込むことのできるポインタを返す。 |
| Play | サウンド バッファを再生カーソルの位置から再生する。 |
| SetCurrentPosition | 再生カーソルの位置を設定する。再生カーソルは、バッファから次のデータ バイトが読み込まれる位置を表す。 |
| Stop | サウンド バッファの再生を停止する。 |
| Unlock | サウンド バッファをアンロックする。 |
サウンドのパラメータ
| メソッド | 説明 |
| GetFrequency | バッファが再生されている周波数 (1 秒あたりのサンプリング数) を取得する。 |
| GetPan | 左右のオーディオ チャンネルの相対ボリュームを取得する。 |
| GetVolume | サウンドの減衰を取得する。 |
| SetFrequency | サンプリング オーディオの再生周波数を設定する。 |
| SetPan | 左右のチャンネルの相対ボリュームを設定する。 |
| SetVolume | サウンドの減衰を設定する。 |
その他
| メソッド | 説明 |
| GetCaps | バッファ オブジェクトの能力を取得する。 |
| GetFormat | バッファ内のサウンド データのフォーマットに関する情報、またはフォーマットの記述を取得するために必要なバッファ サイズを取得する。 |
| GetStatus | サウンド バッファのステータスを取得する。 |
| Initialize | 初期化されていない サウンド バッファ オブジェクトを初期化する。 |
| SetFormat | プライマリ バッファのフォーマットを設定する。 |
次の表は、DirectMusic オーディオパスから取得されるバッファ オブジェクトでサポートされているメソッドをまとめたものである。ミックスイン バッファは、他のバッファからの送信を受け入れ、DirectMusic Producer で作成されたオーディオパス構成にのみ存在する。オーディオパスの他のバッファはすべて、シンクイン バッファである。シンクイン バッファは、シンセサイザ シンクだけからデータを受け入れる。
| IDirectSoundBuffer8 のメソッド | ミックスイン | シンクイン |
| AcquireResources | サポートされない | サポートされない |
| GetCaps | サポートされる | サポートされる |
| GetCurrentPosition | サポートされない | サポートされない |
| GetFormat | サポートされる | サポートされる |
| GetFrequency | サポートされない | サポートされない |
| GetObjectInPath | サポートされる | サポートされる |
| GetPan | サポートされる | サポートされる |
| GetStatus | サポートされる | サポートされる |
| GetVolume | サポートされる | サポートされる |
| Initialize | サポートされない | サポートされない |
| Lock | サポートされない | サポートされない |
| Play | サポートされる | サポートされない |
| Restore | サポートされない | サポートされない |
| SetCurrentPosition | サポートされない | サポートされない |
| SetFormat | サポートされない | サポートされない |
| SetFrequency | サポートされない | サポートされない |
| SetFX | サポートされる | サポートされる |
| SetPan | サポートされる | サポートされる |
| SetVolume | サポートされる | サポートされる |
| Stop | サポートされる | サポートされない |
| Unlock | サポートされない | サポートされない |
LPDIRECTSOUNDBUFFER8 型は、IDirectSoundBuffer インターフェイスへのポインタとして定義されている。
typedef struct IDirectSoundBuffer8 *LPDIRECTSOUNDBUFFER8;
要件
** ヘッダー:**dsound.h で宣言。
参照