Skip to main content

CreateRenderAudioStateMonitor

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

語法

參數

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

傳回值

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

備註

這是建立並傳回 AudioStateMonitor 執行個體的函式之一。 擷取串流和轉譯串流各有四種變化,用來判斷 處理序是否能針對指定角色執行下列其中一項:
  • 擷取或轉譯任何類別的任何音訊
  • 擷取或轉譯特定類別的音訊
  • 擷取或轉譯特定類別的音訊,並傳送到特定端點。
    端點可以使用 MMDevice ID (使用 IMMDevice::GetId() 取得) 指定,或使用其 SWD ID (使用 Windows.Devices.Enumeration 或 Windows.Media.Devices.MediaDevice 取得) 指定
  • 擷取或轉譯特定類別的音訊,並傳送到預設端點
請考慮下列案例:遊戲只有在確知音訊不會因原則而被 OS 靜音時,才會播放 GameMedia 音訊。為此,遊戲會在預設主機端點上,註冊 AudioCategory_GameMedia 串流類別的 SoundLevel 通知。如果此類別的 SoundLevel 設定為 ‘Muted’,遊戲會停止播放其 GameMedia 串流。如果 SoundLevel 設定為其他任何值,遊戲會選擇播放其 GameMedia 串流。

需求

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

另請參閱

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