共用方式為

IAudioEndpointVolume：：SetMute 方法 (endpointvolume.h)

  • 發行項

SetMute方法會設定進入或離開音訊端點裝置之音訊資料流程的靜音狀態。

語法

HRESULT SetMute(
  [in] BOOL    bMute,
  [in] LPCGUID pguidEventContext
);

參數

[in] bMute

新的靜音狀態。 如果 bMute 為 TRUE，方法會將資料流程靜音。 如果為 FALSE，則方法會關閉靜音。

[in] pguidEventContext

IAudioEndpointVolumeCallback：：OnNotify方法的內容值。 此參數指向事件內容 GUID。 如果 SetMute 呼叫變更端點的靜音狀態，則已向該端點註冊 IAudioEndpointVolumeCallback 介面的所有用戶端都會收到通知。 在 OnNotify 方法的實作中，用戶端可以檢查事件內容 GUID，以探索事件內容 GUID 或另一個用戶端是否為控制項變更事件的來源。 如果呼叫端提供此參數的 Null 指標，通知常式會收到內容 GUID 值GUID_Null。

傳回值

如果方法成功且靜音狀態變更，方法會傳回S_OK。 如果方法成功，且新的靜音狀態與先前的靜音狀態相同，則方法會傳回S_FALSE。 如果方法失敗，可能的傳回碼包括但不限於下表所示的值。

傳回碼 描述
E_OUTOFMEMORY
 記憶體不足。

備註

如需呼叫 SetMute的程式碼範例，請參閱 端點磁片區控制項。

需求

   
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 endpointvolume.h

另請參閱

IAudioEndpointVolume 介面

IAudioEndpointVolumeCallback 介面

IAudioEndpointVolumeCallback：：OnNotify