> ## 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::GetFlightStickInfo

> Recupera las propiedades de palanca de vuelo del dispositivo, como las etiquetas de sus botones, su hat switch y sus ejes.

Recupera las propiedades de palanca de vuelo del dispositivo, como las etiquetas de sus botones, su hat switch y sus ejes.

## Sintaxis

```cpp theme={null}
bool GetFlightStickInfo(
    GameInputFlightStickInfo* info
);
```

### Parámetros

*info*   \_Out\_\
Tipo: [GameInputFlightStickInfo](https://docs.xbox.com/es/reference/input/gameinput/structs/gameinputflightstickinfo.md)\*

Puntero a una estructura `GameInputFlightStickInfo` que recibe las propiedades de palanca de vuelo del dispositivo. Si el dispositivo no admite la entrada de palanca de vuelo, todos los miembros de la estructura se establecen en cero.

### Valor devuelto

Tipo: bool

`true` si el dispositivo admite la entrada de palanca de vuelo y se rellenó *info*; de lo contrario, `false`.

## Comentarios

El método `GetFlightStickInfo` copia las propiedades de palanca de vuelo del dispositivo en la estructura proporcionada por el autor de la llamada. Un dispositivo admite la entrada de palanca de vuelo cuando el valor devuelto por [GetSupportedInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md) incluye `GameInputKindFlightStick`. Si el dispositivo no admite la entrada de palanca de vuelo, `GetFlightStickInfo` inicializa *info* con ceros y devuelve `false`.

Los miembros de etiqueta describen las marcas impresas en los controles correspondientes, como valores de [GameInputLabel](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputlabel.md), para que pueda mostrar indicaciones coincidentes en la interfaz de usuario. Los miembros `extraButtonCount` y `extraAxisCount` indican cuántos botones y ejes de mando tiene el dispositivo además de la asignación estándar de palanca de vuelo; use [GetExtraButtonIndexes](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes.md) y [GetExtraAxisIndexes](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxisindexes.md) para localizarlos en el estado del mando de una lectura. El estado de la palanca de vuelo se lee de las lecturas mediante [IGameInputReading::GetFlightStickState](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getflightstickstate.md).

Las propiedades que devuelve este método son fijas durante la vida útil del dispositivo, por lo que puede consultarlas una vez (por ejemplo, cuando se conecta el dispositivo) y almacenar en caché el resultado.

En el siguiente ejemplo se muestra cómo consultar las propiedades de palanca de vuelo de un dispositivo.

```cpp theme={null}
GameInputFlightStickInfo info;
if (device->GetFlightStickInfo(&info))
{
    GameInputLabel firePrimary = info.firePrimaryButtonLabel;
    // ...
}
```

En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro `flightStickInfo` de la estructura [GameInputDeviceInfo](https://docs.xbox.com/es/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) devuelta por [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md).

## Requisitos

**Encabezado:** GameInput.h

**Biblioteca:** gameinput.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Información general de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-overview.md)\
[GameInputFlightStickInfo](https://docs.xbox.com/es/reference/input/gameinput/structs/gameinputflightstickinfo.md)\
[GetSupportedInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md)\
[GameInputKind](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputkind.md)\
[GameInputLabel](https://docs.xbox.com/es/reference/input/gameinput/enums/gameinputlabel.md)\
[IGameInputReading::GetFlightStickState](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getflightstickstate.md)\
[IGameInputDevice](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## Historial de versiones

| Versión | Cambios |
| - | - |
| **v4** | Se introdujo. |


## Related topics

- [GameInputFlightStickInfo](https://docs.xbox.com/es/reference/input/gameinput/structs/gameinputflightstickinfo.md)
- [IGameInputDevice::GetArcadeStickInfo](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getarcadestickinfo.md)
- [IGameInputDevice::GetInputReportInfo](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getinputreportinfo.md)
- [IGameInputDevice::GetKeyboardInfo](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getkeyboardinfo.md)
- [IGameInputDevice::GetGamepadInfo](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getgamepadinfo.md)