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

> Recupera las propiedades de teclado del dispositivo, como el tipo de teclado, la distribución y el número de teclas.

Recupera las propiedades de teclado del dispositivo, como el tipo de teclado, la distribución y el número de teclas.

## Sintaxis

```cpp theme={null}
bool GetKeyboardInfo(
    GameInputKeyboardInfo* info
);
```

### Parámetros

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

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

### Valor devuelto

Tipo: bool

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

## Comentarios

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

La mayoría de las propiedades de teclado son fijas durante la vida útil del dispositivo. La excepción es el miembro `layout`, que GameInput actualiza en su lugar cuando cambia la distribución de teclado activa (por ejemplo, cuando el usuario cambia de idioma de entrada). Cuando cambia la distribución, GameInput genera el evento `GameInputDeviceEventKeyboardLayoutUpdated` de [GameInputDeviceEvent](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent) para las devoluciones de llamada de dispositivo registradas con [IGameInput::RegisterDeviceCallback](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md). Vuelva a llamar a `GetKeyboardInfo` desde esa devolución de llamada para leer la nueva distribución.

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

```cpp theme={null}
GameInputKeyboardInfo info;
if (device->GetKeyboardInfo(&info))
{
    uint32_t keyboardLayout = info.layout;
    uint32_t keyCount = info.keyCount;
    // ...
}
```

En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro `keyboardInfo` 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)\
[GameInputKeyboardInfo](https://docs.xbox.com/es/reference/input/gameinput/structs/gameinputkeyboardinfo.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)\
[IGameInput::RegisterDeviceCallback](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)\
[GameInputDeviceEvent](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent)\
[IGameInputReading::GetKeyState](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getkeystate.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

- [GameInputKeyboardInfo](https://docs.xbox.com/es/reference/input/gameinput/structs/gameinputkeyboardinfo.md)
- [IGameInput::RegisterKeyboardLayoutCallback (en desuso)](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback.md)
- [IGameInput::RegisterDeviceCallback](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [IGameInputDevice::GetInputReportInfo](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getinputreportinfo.md)
- [IGameInputDevice::GetGamepadInfo](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getgamepadinfo.md)