Skip to main content

XUserRegisterForDeviceAssociationChanged

ユーザー デバイス関連付けの変更イベントに対するコールバックを登録します。

構文

パラメーター

queue   _In_opt_
Type: XTaskQueueHandle
変更コールバックを配置する非同期キューへのハンドルです。 context   _In_opt_
Type: void*
アプリケーションが定義し、コールバックに再び渡されるコールバックです。 callback   _In_
Type: XUserDeviceAssociationChangedCallback*
アプリケーションが定義し、登録するコールバックです。 token   _Out_
Type: XTaskQueueRegistrationToken*
成功時に、コールバックを識別するトークンが格納されます。このトークンを使ってコールバックを登録解除できます。

戻り値

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

解説

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

要件

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

概念ドキュメント

関連項目

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