IAudioEndpointVolume：：SetMasterVolumeLevel 方法 (endpointvolume.h)
SetMasterVolumeLevel方法會設定進入或離開音訊端點裝置之音訊資料流程的主要音量層級，以分貝為單位。
語法
HRESULT SetMasterVolumeLevel(
[in] float fLevelDB,
[in] LPCGUID pguidEventContext
);
參數
[in] fLevelDB
以小數為單位的新主要磁片區層級。 若要取得這個方法可設定之磁片區層級的範圍和細微性，請呼叫 IAudioEndpointVolume：：GetVolumeRange 方法。
[in] pguidEventContext
IAudioEndpointVolumeCallback：：OnNotify方法的內容值。 此參數指向事件內容 GUID。 如果 SetMasterVolumeLevel 呼叫變更端點的磁片區層級，則所有已註冊 IAudioEndpointVolumeCallback 介面的用戶端都會收到通知。 在 OnNotify 方法的實作中，用戶端可以檢查事件內容 GUID，以探索它或另一個用戶端是否為磁片區變更事件的來源。 如果呼叫端提供此參數的 Null 指標，通知常式會收到內容 GUID 值GUID_Null。
傳回值
如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括，但不限於下表所示的值。
| 傳回碼 | 描述 |
|---|---|
|
參數 fLevelDB 位於裝置支援的磁片區範圍之外。 |
|
記憶體不足。 |
備註
如果磁片區層級 fLevelDB 落在 IAudioEndpointVolume：：GetVolumeRange 方法所報告的磁片區範圍之外， SetMasterVolumeLevel 呼叫就會失敗，並傳回錯誤碼E_INVALIDARG。
需求
| 最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | endpointvolume.h |
另請參閱
IAudioEndpointVolume：：GetVolumeRange