XUserRegisterForDeviceAssociationChanged
ユーザー デバイスの関連付け変更イベントに対するコールバックを登録します。
構文
HRESULT XUserRegisterForDeviceAssociationChanged(
XTaskQueueHandle queue,
void* context,
XUserDeviceAssociationChangedCallback* callback,
XTaskQueueRegistrationToken* token
)
パラメーター
queue _In_opt_
型: XTaskQueueHandle
変更コールバックを配置する非同期キューのハンドル。
context _In_opt_
型: void*
アプリケーションが定義してそのコールバックに戻すコールバック。
callback _In_
型: XUserDeviceAssociationChangedCallback*
アプリケーションが定義して登録するコールバック。
token _Out_
型: XTaskQueueRegistrationToken*
成功した場合、コールバックを示すトークンが格納されます。これはコールバックを登録解除するために使用できます。
戻り値
型: HRESULT
HRESULT 成功またはエラー コード。
エラー コードの一覧については、「エラー コード」を参照してください。
解説
注意
この関数は、時間依存のスレッドで呼び出すのに安全ではありません。 詳細については、「時間依存のスレッド」を参照してください。
XUserDeviceAssociationRegisterForChangeEvent の呼び出しでは、以前登録されたコールバックは無効になりません。
ユーザー デバイスの関連付け変更コールバックを登録解除するには、XUserUnregisterForDeviceAssociationChanged を呼び出します。
既定のエンドポイントが変更されたときにアプリケーションが定義して呼び出すコールバックを登録するには、XUserRegisterForDefaultAudioEndpointUtf16Changed を呼び出します。
既定のオーディオ エンドポイント変更コールバックを登録解除するには、XUserUnregisterForDefaultAudioEndpointUtf16Changed を呼び出します。
要件
ヘッダー: XUser.h
ライブラリ: xgameruntime.lib
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体
関連項目
XUserUnregisterForDeviceAssociationChanged