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

Sintaxis

Parámetros

info   _Out_
Tipo: GameInputKeyboardInfo*
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 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 para las devoluciones de llamada de dispositivo registradas con IGameInput::RegisterDeviceCallback. 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.
En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro keyboardInfo de la estructura GameInputDeviceInfo devuelta por IGameInputDevice::GetDeviceInfo.

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
GameInputKeyboardInfo
GetSupportedInput
GameInputKind
IGameInput::RegisterDeviceCallback
GameInputDeviceEvent
IGameInputReading::GetKeyState
IGameInputDevice

Historial de versiones

Última modificación el 6 de noviembre de 2026