XUserRegisterForDefaultAudioEndpointUtf16Changed

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

構文

HRESULT XUserRegisterForDefaultAudioEndpointUtf16Changed(  
         XTaskQueueHandle queue,  
         void* context,  
         XUserDefaultAudioEndpointUtf16ChangedCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  

パラメーター

queue _In_opt_
型: XTaskQueueHandle

変更コールバックを配置する非同期キューのハンドル。

context _In_opt_
型: void*

アプリケーションが定義してコールバックに渡すコンテキスト。

callback _In_
型: XUserDefaultAudioEndpointUtf16ChangedCallback*

オーディオ エンドポイント変更イベントに対してアプリケーションが定義して登録するコールバック。

token _Out_
型: XTaskQueueRegistrationToken*

成功した場合、コールバックを識別するトークンを受け取ります。 コールバックを登録解除するには、このトークンを XUserUnregisterForDefaultAudioEndpointUtf16Changed 関数に渡します。

戻り値

型: HRESULT

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

解説

注意

この関数は、時間依存のスレッドで呼び出すのに安全ではありません。 詳細については、「時間依存のスレッド」を参照してください。

以前登録した既定のオーディオ エンドポイント変更コールバックを登録解除するには、XUserUnregisterForDefaultAudioEndpointUtf16Changed を呼び出します。

ユーザー デバイスの関連付けコールバックを登録するには、XUserRegisterForDeviceAssociationChanged を呼び出します。

以前登録したユーザー デバイスの関連付け変更コールバックを登録解除するには、XUserUnregisterForDeviceAssociationChanged を呼び出します。

要件

ヘッダー: XUser.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

XUser
XUserDefaultAudioEndpointUtf16ChangedCallback
XUserUnregisterForDefaultAudioEndpointUtf16Changed