> ## 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)

지정된 입력 유형 중 적어도 하나를 지원하는 장치에 대해서만 등록된 콜백이 트리거되도록 제한합니다.

*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](/ko/reference/input/gameinput/functions/gameinputreadingcallback.md)
- [IGameInput::StopCallback](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback.md)
- [IGameInput::FindDeviceFromId](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md)
- [IGameInput::UnregisterCallback](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md)
- [IGameInput::RegisterDeviceCallback](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)