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

# IGameInputDevice::GetSensorsInfo

> Récupère les propriétés des capteurs du périphérique, comme les capteurs de mouvement et d'orientation dont il dispose.

Récupère les propriétés des capteurs du périphérique, comme les capteurs de mouvement et d'orientation dont il dispose.

## Syntaxe

```cpp theme={null}
bool GetSensorsInfo(
    GameInputSensorsInfo* info
);
```

### Paramètres

*info*   \_Out\_\
Type : [GameInputSensorsInfo](https://docs.xbox.com/fr/reference/input/gameinput/structs/gameinputsensorsinfo.md)\*

Pointeur vers une structure `GameInputSensorsInfo` qui reçoit les propriétés des capteurs du périphérique. Si le périphérique ne prend pas en charge l'entrée de capteurs, tous les membres de la structure sont définis sur zéro.

### Valeur de retour

Type : bool

`true` si le périphérique prend en charge l'entrée de capteurs et que *info* a été renseigné ; sinon, `false`.

## Remarques

La méthode `GetSensorsInfo` copie les propriétés des capteurs du périphérique dans la structure fournie par l'appelant. Un périphérique prend en charge l'entrée de capteurs lorsque la valeur retournée par [GetSupportedInput](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md) inclut `GameInputKindSensors`. Si le périphérique ne prend pas en charge l'entrée de capteurs, `GetSensorsInfo` initialise *info* à zéro et retourne `false`.

Le membre `supportedSensors` est une combinaison d'indicateurs [GameInputSensorsKind](https://docs.xbox.com/fr/reference/input/gameinput/enums/gameinputsensorskind.md) qui identifie les capteurs du périphérique. L'état des capteurs est lu à partir des lectures à l'aide de [IGameInputReading::GetSensorsState](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsensorsstate.md).

Les propriétés retournées par cette méthode sont fixes pendant toute la durée de vie du périphérique ; vous pouvez donc les interroger une seule fois (par exemple, lors de la connexion du périphérique) et mettre le résultat en cache.

L'exemple suivant montre comment interroger les propriétés des capteurs d'un périphérique.

```cpp theme={null}
GameInputSensorsInfo info;
if (device->GetSensorsInfo(&info))
{
    if (info.supportedSensors & GameInputSensorsGyrometer)
    {
        // Enable gyro aiming.
    }
}
```

Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles via le membre `sensorsInfo` de la structure [GameInputDeviceInfo](https://docs.xbox.com/fr/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) retournée par [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/fr/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md).

## Configuration requise

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

**Bibliothèque :** gameinput.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[Vue d'ensemble de GameInput](https://docs.xbox.com/fr/build/core-features/common/input/overviews/input-overview.md)\
[GameInputSensorsInfo](https://docs.xbox.com/fr/reference/input/gameinput/structs/gameinputsensorsinfo.md)\
[GetSupportedInput](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md)\
[GameInputKind](https://docs.xbox.com/fr/reference/input/gameinput/enums/gameinputkind.md)\
[GameInputSensorsKind](https://docs.xbox.com/fr/reference/input/gameinput/enums/gameinputsensorskind.md)\
[IGameInputReading::GetSensorsState](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsensorsstate.md)\
[IGameInputDevice](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## Historique des versions

| Version | Modifications |
| - | - |
| **v4** | Introduite. |


## Related topics

- [GameInputSensorsInfo](https://docs.xbox.com/fr/reference/input/gameinput/structs/gameinputsensorsinfo.md)
- [GameInputSensorsKind](https://docs.xbox.com/fr/reference/input/gameinput/enums/gameinputsensorskind.md)
- [IGameInputDevice::GetInputReportInfo](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getinputreportinfo.md)
- [IGameInputDevice::GetKeyboardInfo](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getkeyboardinfo.md)
- [IGameInputDevice::GetGamepadInfo](https://docs.xbox.com/fr/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getgamepadinfo.md)