> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateCaptureAudioStateMonitorForCategoryAndDeviceId

> CreateCaptureAudioStateMonitorForCategoryAndDeviceId

# CreateCaptureAudioStateMonitorForCategoryAndDeviceId

\[部分資訊與發行前產品有關，在正式發行前可能會有大幅修改。Microsoft 對此處提供的資訊不做任何明示或暗示的保證。]

建立新的 [IAudioStateMonitor](/zh-TW/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor) 執行個體，以監視具有指定 `device` 識別碼之音訊端點在指定類別中所有音訊擷取串流的音訊層級。

## 語法

```cpp theme={null}
HRESULT WINAPI CreateCaptureAudioStateMonitorForCategoryAndDeviceId(
  AUDIO_STREAM_CATEGORY category,
  PCWSTR deviceId,
  _Out_ IAudioStateMonitor **audioStateMonitor
);
```

### 參數

*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](https://learn.microsoft.com/windows/win32/api/audiosessiontypes/ne-audiosessiontypes-audio_stream_category)

[關於 WASAPI](https://learn.microsoft.com/windows/desktop/CoreAudio/wasapi)

[WASAPI](/zh-TW/build/console-features/audio/overviews/wasapi-overview)

[XAudio2 概觀](/zh-TW/build/console-features/audio/overviews/xaudio2-overview)

[音訊概觀](/zh-TW/build/console-features/audio/overviews/audio)


## Related topics

- [CreateCaptureAudioStateMonitorForCategoryAndDeviceId](/reference/audio/audiostatemonitor/functions/createcaptureaudiostatemonitorforcategoryanddeviceid.md)
- [IAudioStateMonitor interface](/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor.md)
- [AudioStateMonitor](/reference/audio/audiostatemonitor/audiostatemonitor_members.md)
- [Interfaz IAudioStateMonitor](/es/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor.md)
- [IAudioStateMonitor 接口](/zh-CN/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor.md)