IPerChannelDbLevel::GetLevelRange メソッド (devicetopology.h)

  • [アーティクル]

GetLevelRange メソッドは、指定されたチャネルのボリューム レベルの範囲をデシベル単位で取得します。

構文

HRESULT GetLevelRange(
  [in]  UINT  nChannel,
  [out] float *pfMinLevelDB,
  [out] float *pfMaxLevelDB,
  [out] float *pfStepping
);

パラメーター

[in] nChannel

選択したチャネルの番号。 オーディオ ストリームに n 個のチャネルがある場合、チャネルには 0 ~ n – 1 の番号が付きます。 ストリーム内のチャネルの数を取得するには、 IPerChannelDbLevel::GetChannelCount メソッドを呼び出します。

[out] pfMinLevelDB

メソッドが最小ボリューム レベルをデシベルで書き込む float 変数へのポインター。

[out] pfMaxLevelDB

メソッドが最大ボリューム レベルをデシベルで書き込む float 変数へのポインター。

[out] pfStepping

*pfMinLevelDB の範囲内の連続するボリューム レベル間のステップ値を *pfMaxLevelDB に書き込む float 変数へのポインター。 最大ボリューム レベルと最小ボリューム レベルの差が d デ シベルで、範囲が n 個のステップ (均一なサイズの間隔) に分割されている場合、ボリュームには n + 1 個の不連続レベルがあり、連続するレベル間のステップのサイズは d / n デシベルになります。

戻り値

メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

リターン コード 説明
E_INVALIDARG
 パラメーター nChannel が範囲外です。
E_POINTER
 ポインター pfminLevelDB、 pfmaxLevelDB、または pfmaxLevelDB が NULL です。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー devicetopology.h

こちらもご覧ください

IPerChannelDbLevel インターフェイス

IPerChannelDbLevel::GetChannelCount