Skip to main content

​
CreateRenderAudioStateMonitorForCategoryAndDeviceId

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

​
語法

​
參數

category
類型: AUDIO_STREAM_CATEGORY AUDIO_STREAM_CATEGORY 列舉的成員，指定要監視的音訊轉譯串流類別。 deviceId
類型: PCWSTR device ID，指定要監視其音訊轉譯串流的音訊端點。 audioStateMonitor _Out_
類型: IAudioStateMonitor** 此輸出參數會填入所建立的 IAudioStateMonitor 物件。

​
傳回值

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

​
備註

這是建立並傳回 AudioStateMonitor 執行個體的函式之一。 擷取串流和轉譯串流各有四種變化，用來判斷處理序是否能針對指定角色執行下列其中一項：
  • 擷取或轉譯任何類別的任何音訊
  • 擷取或轉譯特定類別的音訊
  • 擷取或轉譯特定類別的音訊，並傳送到特定端點。
    端點可以使用 MMDevice ID (使用 IMMDevice::GetId() 取得) 指定，或使用其 SWD ID (使用 Windows.Devices.Enumeration 或 Windows.Media.Devices.MediaDevice 取得) 指定
  • 擷取或轉譯特定類別的音訊，並傳送到預設端點

​
需求

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

​
另請參閱

AUDIO_STREAM_CATEGORY 關於 WASAPI WASAPI 音訊概觀
Last modified on October 6, 2026