IAudioPeakMeter::GetLevel メソッド (devicetopology.h)

GetLevel メソッドは、そのチャネルのピークレベルが以前に読み取られたため、指定されたチャネルに対して記録されたピークメーターのピークレベルを取得します。

構文

HRESULT GetLevel(
  [in]  UINT  nChannel,
  [out] float *pfLevel
);

[in] nChannel

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

[out] pfLevel

メソッドがピークメーターレベルをデシベルで書き込む float 変数へのポインター。

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

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