DSBCAPS
DirectSound バッファ オブジェクトの能力を記述する。IDirectSoundBuffer8::GetCaps メソッドで使われる。
typedef struct {
DWORD dwSize;
DWORD dwFlags;
DWORD dwBufferBytes;
DWORD dwUnlockTransferRate;
DWORD dwPlayCpuOverhead;
} DSBCAPS, *LPDSBCAPS;
typedef const DSBCAPS *LPCDSBCAPS;
メンバ
- dwSize
- 構造体のサイズ (バイト単位)。この構造体を使う前に、このメンバを初期化しなければならない。
- dwFlags
- バッファ オブジェクトの能力を指定するフラグ。
- DSBCAPS_CTRL3D
- バッファは 3D コントロール能力を備えている。
- DSBCAPS_CTRLFREQUENCY
- バッファは周波数コントロール能力を備えている。
- DSBCAPS_CTRLFX
- バッファはエフェクト処理をサポートしている。
- DSBCAPS_CTRLPAN
- バッファはパン コントロール能力を備えている。
- DSBCAPS_CTRLVOLUME
- バッファはボリューム コントロール能力を備えている。
- DSBCAPS_CTRLPOSITIONNOTIFY
- バッファは位置通知能力を備えている。「DSBUFFERDESC」の「注意」を参照すること。
- DSBCAPS_GETCURRENTPOSITION2
- IDirectSoundBuffer8::GetCurrentPosition が再生カーソルの新しい動作を使うべきであることを示す。DirectX 1 の DirectSound では、エミュレートされたサウンド カード上で再生カーソルは実際に再生されているサウンドよりはるかに前方にあり、書き込みカーソルの直後に置かれていた。現在は、DSBCAPS_GETCURRENTPOSITION2 フラグを指定すると、アプリケーションはより正確な再生カーソルを取得できる。このフラグを指定していない場合、互換性を保つ目的で過去の動作が維持される。このフラグは、エミュレートされたサウンド カードにのみ影響を及ぼす点に注意すること。DirectSound ドライバが存在する場合、DirectX のどのバージョンでも、DirectSound の再生カーソルは正確な位置を示す。
- DSBCAPS_GLOBALFOCUS
- このバッファはグローバルなサウンド バッファである。このフラグを設定すると、ユーザーがほかのアプリケーションにフォーカスを移動し、その新しいアプリケーションが DirectSound を使う場合でも、DirectSound を使っているアプリケーションは引き続きそのバッファを再生できる。1 つの例外は、協調レベルで DSSCL_WRITEPRIMARY フラグを設定した DirectSound アプリケーションにフォーカスを移動した場合である。この場合、ほかのアプリケーションからのグローバルなサウンドは聞こえなくなる。
- DSBCAPS_LOCDEFER
- 再生時、または IDirectSoundBuffer8::AcquireResources が呼び出されたときに、バッファはハードウェアまたはソフトウェアのリソースに割り当てられる。
- DSBCAPS_LOCHARDWARE
- バッファはハードウェア ミキシングを使う。
- DSBCAPS_LOCSOFTWARE
- バッファはソフトウェア メモリ内にあり、ソフトウェア ミキシングを使う。
- DSBCAPS_MUTE3DATMAXDISTANCE
- サウンドは、最大距離で無音になる。最大距離を超えるとバッファの再生が停止するので、プロセッサ時間を消費しないで済む。
- DSBCAPS_PRIMARYBUFFER
- このバッファはプライマリ サウンド バッファである。
- DSBCAPS_STATIC
- バッファはオンボード ハードウェア メモリにある。
- DSBCAPS_STICKYFOCUS
- バッファはスティッキー フォーカスを備えている。ユーザーが DirectSound を使っていないほかのアプリケーションに切り替えた場合、バッファは引き続き音を出す。ただし、ユーザーがほかの DirectSound アプリケーションに切り替えた場合、バッファは無音になる。
- dwBufferBytes
- このバッファのサイズ (バイト単位)。
- dwUnlockTransferRate
- IDirectSoundBuffer8::Unlock を呼び出したときにデータをバッファ メモリに転送する速度を指定する。単位は 1 秒あたりのキロバイト (KB/s)。高性能のアプリケーションはこの値を使って、IDirectSoundBuffer8::Unlock を実行するために必要な時間を決定できる。システム メモリ内に配置されているソフトウェア バッファの場合、処理が不要なので転送速度は非常に高い。ハードウェア バッファの場合、バッファをサウンド カードにロードしなければならない可能性があるので、転送速度はより遅くなる可能性がある。その結果、転送速度が制限されることがある。
- dwPlayCpuOverhead
- 処理のオーバーヘッドを指定する。これは、サウンド バッファをミキシングするのに必要なメイン処理サイクルのパーセンテージである。ハードウェア バッファの場合、サウンド デバイスがミキシングを行うので、このメンバは 0 である。ソフトウェア バッファの場合、このメンバの値はバッファ フォーマットとシステム プロセッサの速度に依存する。
注意
DSBCAPS 構造体は、IDirectSound8::CreateSoundBuffer メソッドに渡される DSBUFFERDESC 構造体に似た情報と、それ以外のいくつかの追加情報を保持している。追加情報として、バッファの位置 (ハードウェアまたはソフトウェア) と、いくつかのコスト測定値 (たとえば、バッファがハードウェアに配置されている場合はダウンロード時間、ソフトウェアでバッファをミキシングする場合は再生処理のオーバーヘッドなど) が挙げられる。
dwFlags メンバは、DSBUFFERDESC 構造体で使用される同じフラグを保持する。唯一の違いは、DSBCAPS 構造体ではバッファの場所に応じて DSBCAPS_LOCHARDWARE と DSBCAPS_LOCSOFTWARE のどちらかが指定されることである。DSBUFFERDESC 構造体ではこれらのフラグはオプションであり、フラグの指定に応じて、バッファをハードウェアとソフトウェアのどちらかに強制的に配置できる。
ヘッダー : dsound.h で宣言。
参照
IDirectSound8::CreateSoundBuffer、IDirectSoundBuffer8::GetCaps