Skip to main content

CreateCaptureAudioStateMonitor

[部分資訊與發行前產品有關,在正式發行前可能會有大幅修改。Microsoft 對此處提供的資訊不做任何明示或暗示的保證。] 建立新的 IAudioStateMonitor 執行個體,以監視所有音訊擷取串流的音訊層級。

語法

參數

audioStateMonitor _Out_ 類型:IAudioStateMonitor** 此輸出參數會填入所建立的 IAudioStateMonitor 物件。

傳回值

類型:HRESULT 如果方法成功,則會傳回 S\_OK。

備註

這是建立並傳回 AudioStateMonitor 執行個體的函式之一。 擷取和轉譯串流各有四種變體,用來判斷 處理序是否可針對指定的角色執行下列其中一項動作:
  • 擷取或轉譯任何類別的任何音訊
  • 擷取或轉譯特定類別的音訊
  • 將特定類別的音訊擷取或轉譯至特定端點。
    可以使用 MMDevice 識別碼 (使用 IMMDevice::GetId() 取得) 或其 SWD 識別碼 (使用 Windows.Devices.Enumeration 或 Windows.Media.Devices.MediaDevice 取得) 來指定端點
  • 將特定類別的音訊擷取或轉譯至預設端點
請考慮下列案例:遊戲只想在知道音訊不會因作業系統原則而遭靜音時,才啟用其遊戲內的 GameChat 功能。為此,遊戲會在預設通訊端點上,針對 AudioCategory_GameChat 串流類別註冊 SoundLevel 通知。 如果此類別的 SoundLevel 設定為 ‘Muted’,遊戲會停止其 GameChat 工作階段。如果 SoundLevel 設定為其他任何值,遊戲會選擇啟用其 GameChat 串流。 下列程式碼範例示範遊戲如何針對此案例建立適當的 IAudioStateMonitor 物件。

需求

標頭: Audiostatemonitorapi.h 程式庫: Windows.Media.MediaControl.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

AUDIO_STREAM_CATEGORY 關於 WASAPI WASAPI
Last modified on October 6, 2026