Skip to main content

XUserRegisterForDefaultAudioEndpointUtf16Changed

既定のオーディオ エンドポイントが変更されたときにアプリケーションが定義して呼び出すコールバックを登録します。

構文

パラメーター

queue   _In_opt_
Type: XTaskQueueHandle
変更コールバックを配置する非同期キューへのハンドルです。 context   _In_opt_
Type: void*
アプリケーションが定義してコールバックに渡すコンテキストです。 callback   _In_
Type: XUserDefaultAudioEndpointUtf16ChangedCallback*
アプリケーションが定義し、オーディオ エンドポイント変更イベント用に登録するコールバックです。 token   _Out_
Type: XTaskQueueRegistrationToken*
成功時に、コールバックを識別するトークンを受け取ります。コールバックを登録解除するには、このトークンを XUserUnregisterForDefaultAudioEndpointUtf16Changed 関数に渡します。

戻り値

Type: HRESULT HRESULT の成功またはエラー コード。
エラー コードの一覧については、エラー コード を参照してください。

解説

この関数は、時間依存スレッドから呼び出しても安全ではありません。詳細については、時間依存スレッド を参照してください。
以前に登録した既定のオーディオ エンドポイント変更コールバックを解除するには、XUserUnregisterForDefaultAudioEndpointUtf16Changed を呼び出します。 ユーザー デバイス関連付けコールバックを登録するには、XUserRegisterForDeviceAssociationChanged を呼び出します。 以前に登録したユーザー デバイス関連付け変更コールバックを解除するには、XUserUnregisterForDeviceAssociationChanged を呼び出します。

要件

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

概念ドキュメント

関連項目

XUser
XUserDefaultAudioEndpointUtf16ChangedCallback
XUserUnregisterForDefaultAudioEndpointUtf16Changed
最終更新日 2026年8月24日