> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IGameInput::RegisterReadingCallback

> IGameInput::RegisterReadingCallback

# IGameInput::RegisterReadingCallback

入力ストリームに新しい読み取り値が到着したときに呼び出される関数を登録します。

## 構文

```cpp theme={null}
HRESULT RegisterReadingCallback(
    IGameInputDevice* device,
    GameInputKind inputKind,
    void* context,
    GameInputReadingCallback callbackFunc,
    GameInputCallbackToken* callbackToken
);
```

### パラメーター

*device*   \_In\_opt\_\
型: IGameInputDevice\*

登録されたコールバックを特定のデバイスに対してのみトリガーされるように制限します。

*inputKind*   \_In\_\
型: [GameInputKind](/reference/input/gameinput/enums/gameinputkind)

登録されたコールバックを、指定された入力種別の少なくとも 1 つをサポートするデバイスに対してのみトリガーされるように制限します。

*context*   \_In\_opt\_\
型: void\*

コールバック関数に関連する情報を提供するオブジェクト。通常は呼び出し元のオブジェクト。

*callbackFunc*   \_In\_\
型: GameInputReadingCallback

タイトル定義コールバック関数。

*callbackToken*   \_Result\_zeroonfailure\_\
型: GameInputCallbackToken\*

登録されたコールバック関数を識別するトークン。このトークンは、コールバック関数をキャンセルまたは登録解除したい場合に、登録された関数を識別するために使用されます。

### 戻り値

型: HRESULT

関数の結果。

## 解説

コールバックを登録しても、指定された入力フィルターに一致する最新の読み取り値で初回コールバックがディスパッチされることはありません。以降の状態変化に対してのみコールバックがディスパッチされます。

## 要件

**ヘッダー:** GameInput.h

[Input API の概要](/build/core-features/common/input/overviews/input-overview)\
[IGameInput](/reference/input/gameinput/interfaces/igameinput/igameinput)\
[IGameInput::UnregisterCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback)\
[IGameInput::StopCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback)

## バージョン履歴

| バージョン  | 変更内容     |
| ------ | -------- |
| **v0** | 導入されました。 |


## Related topics

- [GameInputReadingCallback](/ja-jp/reference/input/gameinput/functions/gameinputreadingcallback.md)
- [IGameInput::StopCallback](/ja-jp/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback.md)
- [IGameInput::FindDeviceFromId](/ja-jp/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md)
- [IGameInput::UnregisterCallback](/ja-jp/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md)
- [IGameInput::RegisterDeviceCallback](/ja-jp/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
