ISimpleAudioVolume：：SetMasterVolume 方法 (audioclient.h)
SetMasterVolume 方法會設定音訊會話的主要音量層級。
語法
HRESULT SetMasterVolume(
[in] float fLevel,
[in] LPCGUID EventContext
);
參數
[in] fLevel
新的主磁碟區層級。 有效的磁碟區層級介於 0.0 到 1.0 的範圍內。
[in] EventContext
事件內容 GUID 的指標。 如果呼叫這個方法會產生磁碟區變更事件，會話管理員會傳送通知給已向會話管理員註冊 IAudioSessionEvents 介面的所有用戶端。 會話管理員會在每個通知中包含 EventContext 指標值。 收到通知時，用戶端可以藉由檢查 EventContext 值來判斷它或另一個用戶端是否為事件的來源。 此配置取決於客戶端選取這個參數的值，這個參數在會話中的所有客戶端之間是唯一的。 如果呼叫端提供此參數的 NULL 指標，則用戶端的通知方法會收到 NULL 內容指標。
傳回值
如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括但不限於下表所示的值。
| 傳回碼 | Description |
|---|---|
|
參數 fLevel 不在 0.0 到 1.0 的範圍內。 |
|
音訊端點裝置已解除叢集，或音訊硬體或相關聯的硬體資源已重新設定、停用、移除或無法使用。 |
|
Windows 音訊服務未執行。 |
備註
只有在方法呼叫變更會話的磁碟區層級時，這個方法才會產生磁碟區變更事件。 例如，如果發生呼叫時磁碟區層級為0.4，而呼叫會將磁碟區層級設定為0.4，則不會產生任何事件。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | audioclient.h |