CreateCaptureAudioStateMonitorForCategoryAndDeviceId

[一部の情報は、市販前に大幅に変更される可能性のあるプレリリース製品に関するものです。Microsoft は、ここに記載されている情報に関して、明示または黙示のいかなる保証も行いません。] 指定した device ID を持つオーディオエンドポイントについて、指定したカテゴリのすべてのオーディオキャプチャストリームのオーディオレベルを監視する、IAudioStateMonitor の新しいインスタンスを作成します。

構文

HRESULT WINAPI CreateCaptureAudioStateMonitorForCategoryAndDeviceId(
  AUDIO_STREAM_CATEGORY category,
  PCWSTR deviceId,
  _Out_ IAudioStateMonitor **audioStateMonitor
);

パラメーター

category
型: AUDIO_STREAM_CATEGORY 監視するオーディオキャプチャストリームのカテゴリを指定する、AUDIO_STREAM_CATEGORY 列挙型のメンバーです。 deviceId
型: PCWSTR オーディオキャプチャストリームが監視されるオーディオエンドポイントを指定するデバイス ID です。 audioStateMonitor _Out_
型: IAudioStateMonitor** 作成された IAudioStateMonitor オブジェクトがこの出力パラメーターに設定されます。

戻り値

型: HRESULT メソッドが成功した場合、S\_OK が返されます。

解説

これは、AudioStateMonitor インスタンスを作成して返す関数の 1 つです。キャプチャストリームとレンダーストリームのそれぞれに 4 つのバリアントがあり、特定のロールに対してプロセスが以下のいずれを実行できるかを決定します。

あらゆるカテゴリの任意のオーディオをキャプチャまたはレンダリングする
特定のカテゴリのオーディオをキャプチャまたはレンダリングする
特定のカテゴリのオーディオを特定のエンドポイントに対してキャプチャまたはレンダリングする。エンドポイントは MMDevice ID (IMMDevice::GetId() を使用して取得) または SWD ID (Windows.Devices.Enumeration あるいは Windows.Media.Devices.MediaDevice を使用して取得) を用いて指定できます。
特定のカテゴリのオーディオを既定のエンドポイントに対してキャプチャまたはレンダリングする

要件

ヘッダー: Audiostatemonitorapi.h ライブラリ: Windows.Media.MediaControl.lib サポートされるプラットフォーム: Windows、XBOX One ファミリ本体および XBOX Series 本体

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

CreateCaptureAudioStateMonitorForCategoryAndDeviceId

CreateCaptureAudioStateMonitorForCategoryAndDeviceId

構文

パラメーター

戻り値

解説

要件

関連項目

​CreateCaptureAudioStateMonitorForCategoryAndDeviceId

​構文

​パラメーター

​戻り値

​解説

​要件

​関連項目

CreateCaptureAudioStateMonitorForCategoryAndDeviceId

構文

パラメーター

戻り値

解説

要件

関連項目