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