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

# IGameInput::RegisterKeyboardLayoutCallback (déprécié)

> Inscrit une fonction de rappel appelée lorsqu'une disposition de clavier est modifiée (supprimée dans v4).

> [!WARNING]
>
> **Déconseillé.** Cette méthode a été supprimée dans GameInput v4 et n'est pas disponible dans l'API actuelle. Traitez plutôt l'[événement de périphérique](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent) `GameInputDeviceEventKeyboardLayoutUpdated` et appelez [IGameInputDevice::GetKeyboardInfo](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getkeyboardinfo.md) pour obtenir la nouvelle disposition.

Inscrit une fonction de rappel appelée lorsqu'une disposition de clavier est modifiée.

## Syntaxe

```cpp theme={null}
HRESULT RegisterKeyboardLayoutCallback(
    IGameInputDevice* device,
    void* context,
    GameInputKeyboardLayoutCallback callbackFunc,
    GameInputCallbackToken* callbackToken
);
```

### Paramètres

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

Limite facultativement le rappel inscrit afin qu'il se déclenche pour un appareil spécifique.

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

Un objet qui fournit des renseignements pertinents pour la fonction de rappel. Il s'agit généralement de l'objet appelant.

*callbackFunc*   \_In\_\
Type : [GameInputKeyboardLayoutCallback](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/deprecated/functions/gameinputkeyboardlayoutcallback)

Fonction de rappel définie par le titre, appelée lorsque la disposition du clavier est modifiée.

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

Jeton identifiant la fonction de rappel inscrite. Ce jeton sert à identifier la fonction inscrite si vous devez annuler ou désinscrire la fonction de rappel.

### Valeur de retour

Type : HRESULT

Résultat de la fonction.

## Remarques

La méthode `RegisterKeyboardLayoutCallback` inscrit une fonction de rappel appelée lorsqu'une disposition de clavier est modifiée. Pour des renseignements connexes, consultez les méthodes [IGameInput::UnregisterCallback](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md) et [IGameInput::StopCallback](https://docs.xbox.com/fr-CA/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_stopcallback.md). Pour les cas d'utilisation intermédiaires et avancés de l'API GameInput, consultez [Rubriques avancées sur GameInput](https://docs.xbox.com/fr-CA/build/core-features/common/input/advanced/input-advanced-topics.md).

## Configuration requise

La méthode `RegisterKeyboardLayoutCallback` inscrit une fonction de rappel appelée lorsqu'une disposition de clavier est modifiée. Pour des renseignements connexes, consultez les méthodes [IGameInput::UnregisterCallback](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md) et [IGameInput::StopCallback](https://docs.xbox.com/fr-CA/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_stopcallback.md). Pour les cas d'utilisation intermédiaires et avancés de l'API GameInput, consultez [Rubriques avancées sur GameInput](https://docs.xbox.com/fr-CA/build/core-features/common/input/advanced/input-advanced-topics.md).

**En-tête :** GameInput.h

## Voir aussi

[Membres déconseillés de l'API GameInput](https://docs.xbox.com/fr-CA/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)\
[GameInputDeviceEvent](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent)\
[IGameInputDevice::GetKeyboardInfo](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getkeyboardinfo.md)\
[Vue d'ensemble de GameInput](https://docs.xbox.com/fr-CA/build/core-features/common/input/overviews/input-overview.md)\
[IGameInput](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinput/igameinput.md)

## Historique des versions

| Version | Modifications |
| - | - |
| **v4** | Supprimé. |
| **v0** | Introduit. |


## Related topics

- [IGameInput::RegisterKeyboardLayoutCallback](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback.md)
- [GameInputKeyboardLayoutCallback](https://docs.xbox.com/fr-CA/reference/input/gameinput/functions/gameinputkeyboardlayoutcallback.md)
- [IGameInput::StopCallback (déprécié)](https://docs.xbox.com/fr-CA/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_stopcallback.md)
- [IGameInput::RegisterDeviceCallback](https://docs.xbox.com/fr-CA/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [IGameInput::RegisterGuideButtonCallback (déprécié)](https://docs.xbox.com/fr-CA/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)