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

SetLevelUniform メソッドは、オーディオ ストリーム内のすべてのチャネルを同じ均一ボリューム レベル (デシベル単位) に設定します。

構文

HRESULT SetLevelUniform(
  [in] float   fLevelDB,
  [in] LPCGUID pguidEventContext
);

パラメーター

[in] fLevelDB

デシベルの新しい均一レベル。

[in] pguidEventContext

IControlChangeNotify::OnNotify メソッドのコンテキスト値。 このパラメーターは、イベント コンテキスト GUID を指します。 SetLevelUniform 呼び出しによってレベル コントロールの状態が変更された場合、そのコントロールに IControlChangeNotify インターフェイスを登録しているすべてのクライアントが通知を受け取ります。 OnNotify メソッドの実装では、クライアントはイベント コンテキスト GUID を調べて、その GUID または別のクライアントがコントロール変更イベントのソースであるかどうかを検出できます。 呼び出し元がこのパラメーターに NULL ポインターを指定した場合、クライアントの通知メソッドは NULL コンテキスト ポインターを受け取ります。

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。

リターン コード	説明
E_OUTOFMEMORY	メモリが不足しています。

解説

指定した均一レベルが 、IPerChannelDbLevel::GetLevelRange メソッドが特定のチャネルに対して報告する範囲を超えている場合、 SetLevelUniform 呼び出しは、そのチャネルの値をサポートされている範囲に固定し、正常に完了します。 IPerChannelDbLevel::GetLevel メソッドの後続の呼び出しは、そのチャネルに使用される実際の値を取得します。

要件

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

関連項目

IPerChannelDbLevel インターフェイス

IPerChannelDbLevel::GetLevel

IPerChannelDbLevel::GetLevelRange