構文
パラメーター
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
