メインコンテンツへスキップ
非推奨。 このメソッドは GameInput v4 で削除され、現在の API では利用できません。代わりに、IGameInputReading::GetSystemButtonState と GameInputKindSystemButton を使用して、入力の読み取りからシステム ボタンの状態を読み取ってください。
Guide ボタンまたは Share ボタンが押されたとき、または離されたときに呼び出されるコールバック関数を登録します。

構文

パラメーター

device   _In_opt_
型: IGameInputDevice*
必要に応じて、登録されたコールバックを特定のデバイスに対してのみトリガーされるように制限します。 buttonFilter   _In_
型: GameInputSystemButtons
コールバックを受け取るボタンのセット。論理 OR で組み合わせます。 context   _In_opt_
型: void*
コールバック関数に関連する情報を提供するオブジェクト。通常は呼び出し元のオブジェクト。 callbackFunc   _In_
型: GameInputSystemButtonCallback
システム ボタンが押されたとき、または離されたときに呼び出される、タイトル定義のコールバック関数。 callbackToken   _Out_opt_
型: GameInputCallbackToken*
登録されたコールバック関数を識別するトークン。このトークンは、コールバック関数をキャンセルまたは登録解除する必要があるときに、登録された関数を識別するために使用されます。

戻り値

型: HRESULT 関数の結果。

解説

このメソッドは、Guide ボタンまたは System ボタンが押されたとき、または離されたときに呼び出されるコールバック関数を登録します。コールバックがディスパッチされるかどうかは、自分のプロセスおよび他のプロセスで IGameInput::SetFocusPolicy によって設定された GameInputFocusPolicy によって決まります。詳細については、GameInputFocusPolicy を参照してください。XBOX では、シェルが常に Guide ボタンを消費するため、これらのコールバックが XBOX でディスパッチされることはありません。 PC では、GameInput ランタイムがシステムにインストールされておらず、アプリケーションと共にサイドロードされている場合、このメソッドは GAMEINPUT_E_FEATURE_REQUIRES_INSTALL (0x838AD02B) で失敗します。詳細については、「GameInput のサイドロード」を参照してください。 コールバックの受信を停止する方法については、IGameInput::UnregisterCallback メソッドと IGameInput::StopCallback メソッドを参照してください。 これは Windows SDK 10.0.26031 Preview の GameInput.h で追加されたもので、今後の GDK リリースで追加される予定です。 次のコード例は、Guide ボタンの押下をリッスンする方法を示しています。

要件

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

関連項目

非推奨の GameInput API メンバー
IGameInputReading::GetSystemButtonState
GameInput の高度なトピック
GameInput の概要
IGameInput

バージョン履歴

最終更新日 2026年11月6日