共用方式為

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