Skip to main content

CreateCaptureAudioStateMonitorForCategoryAndDeviceId

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

語法

參數

category
類型:AUDIO_STREAM_CATEGORY
AUDIO_STREAM_CATEGORY 列舉的成員,指定要監視之音訊擷取串流的類別。 deviceId
類型:PCWSTR
指定要監視其音訊擷取串流之音訊端點的裝置識別碼。 audioStateMonitor _Out_
類型:IAudioStateMonitor**
此輸出參數會填入所建立的 IAudioStateMonitor 物件。

傳回值

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

備註

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

需求

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

另請參閱

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