Skip to main content

XGameActivationRegisterForEvent

アクティブ化イベントのコールバックを登録します。

Syntax

Parameters

queue   _In_opt_
型: XTaskQueueHandle
イベント コールバックをディスパッチするタスク キュー。 context   _In_opt_
型: void*
イベント コールバックに渡されるコンテキスト。 callback   _In_
型: XGameActivationCallback*
イベント コールバック関数。 token   _Out_
型: XTaskQueueRegistrationToken*
登録を表すタスク キューからのトークン。このトークンを使用して、アクティブ化イベントのコールバックの登録を解除します。

Return value

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

Remarks

この関数は、時間依存スレッドから呼び出しても安全ではありません。詳細については、Time-sensitive threads を参照してください。
XGameActivationRegisterForEvent 関数は、XGameActivationCallback を引数として使用します。コールバックは、アクティブ化の種類と対応するデータを含む XGameActivationInfo 構造体を受け取ります。 この API は、プロトコル アクティブ化、ファイル アクティブ化、およびゲーム招待を含むすべてのアクティブ化タイプを処理します。非推奨の XGameProtocolRegisterForActivation および XGameInviteRegisterForEvent API を置き換えます。 アクティブ化イベントのコールバックの登録を解除するには、XGameActivationUnregisterForEvent を呼び出します。 この関数の呼び出し例については、XGameActivationCallback トピックの「Remarks」セクションを参照してください。

Requirements

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

Conceptual documentation

See also

XGameActivation XGameActivationCallback XGameActivationUnregisterForEvent
最終更新日 2026年8月24日