Skip to main content

XUserRegisterForChangeEvent

ユーザー変更イベントに対するコールバックを登録します。

構文

パラメーター

queue   _In_opt_
Type: XTaskQueueHandle
操作を実行する非同期キューへのハンドルです。 context   _In_opt_
Type: void*
コールバックに渡すユーザー定義のコンテキストです。 callback   _In_
Type: XUserChangeEventCallback*
登録するユーザー定義のコールバックです。 token   _Out_
Type: XTaskQueueRegistrationToken*
登録されたコールバックを識別するトークンが格納されます。トークンを使用してコールバックを登録解除します。

戻り値

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

解説

この関数は、時間依存スレッドから呼び出しても安全ではありません。詳細については、時間依存スレッド を参照してください。
XUserChangeEvent 列挙体は、変更イベントの種類を指定します。 XUserChangeEventCallback は、ユーザー変更イベントのコールバックです。 以前に登録したユーザー変更コールバックを解除するには、XUserUnregisterForChangeEvent を呼び出します。 以下の例は、ユーザー変更イベントを処理する方法を示しています。

要件

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

概念ドキュメント

関連項目

XUser XUserChangeEvent XUserChangeEventCallback XUserUnregisterForChangeEvent
最終更新日 2026年8月24日