IDirectSound8::GetCaps
GetCaps メソッドはデバイス オブジェクトが示すハードウェア デバイスの能力を取得します。
HRESULT
GetCaps(
LPDSCAPS pDSCaps
);
パラメータ
- pDSCaps
サウンド デバイスの能力を受け取る DSCAPS 構造体のアドレスです。
戻り値
成功した場合は、DS_OK を返します。失敗した場合は、以下の表に示すエラー値のいずれかが戻り値となります。
| リターン コード |
| DSERR_GENERIC |
| DSERR_INVALIDPARAM |
| DSERR_UNINITIALIZED |
解説
DSCAPS 構造体に取得される情報は、ハードウェア ミキシング チャンネルの数やオンボード サウンド メモリーの容量など、サウンド デバイスの最大能力と、現在使用可能な能力を示しています。これらの情報を使用することで、性能を調整し、リソースの割り当てを最適化できます。
リソースの共有の要件によっては、特定の領域で最大の能力を利用すると、他の領域でその影響を受けることがあります。
要件
ヘッダー: DSound.h 宣言
ライブラリ: Dsound3d.dll 内容