IDirectSound8::GetCaps

GetCaps メソッドはデバイス オブジェクトが示すハードウェア デバイスの能力を取得します。

HRESULT 
GetCaps(
  LPDSCAPS pDSCaps
);

パラメータ

  • pDSCaps
    サウンド デバイスの能力を受け取る DSCAPS 構造体のアドレスです。

戻り値

成功した場合は、DS_OK を返します。失敗した場合は、以下の表に示すエラー値のいずれかが戻り値となります。

リターン コード
DSERR_GENERIC
DSERR_INVALIDPARAM
DSERR_UNINITIALIZED

解説 

DSCAPS 構造体に取得される情報は、ハードウェア ミキシング チャンネルの数やオンボード サウンド メモリーの容量など、サウンド デバイスの最大能力と、現在使用可能な能力を示しています。これらの情報を使用することで、性能を調整し、リソースの割り当てを最適化できます。

リソースの共有の要件によっては、特定の領域で最大の能力を利用すると、他の領域でその影響を受けることがあります。

要件

ヘッダー: DSound.h 宣言

ライブラリ: Dsound3d.dll 内容

関連項目

IDirectSound8