Saltar al contenido principal
Recupera el estado de los botones del sistema, como los botones Guía y Compartir, de una lectura de entrada.

Sintaxis

Parámetros

buttons   _Out_
Tipo: GameInputSystemButtons*
Recibe el conjunto de botones del sistema que están presionados en esta lectura.

Valor devuelto

Tipo: bool Devuelve true si la lectura contiene el estado de los botones del sistema. Devuelve false si no lo contiene, en cuyo caso buttons se establece en GameInputSystemButtonNone.

Comentarios

En GameInput v4, los botones del sistema son un tipo de entrada ordinario, GameInputKindSystemButton. Todas las lecturas de un dispositivo que tiene botones del sistema incluyen GameInputKindSystemButton en IGameInputReading::GetInputKind, y GetSystemButtonState devuelve el estado actual de esos botones de la misma manera que IGameInputReading::GetGamepadState devuelve el estado de los botones del mando de juego. Para averiguar qué botones del sistema tiene un dispositivo, llame a IGameInputDevice::GetSupportedSystemButtons. La lectura indica qué botones están presionados, no eventos de pulsación o liberación. Para detectar una pulsación o una liberación, compare el estado con el de la lectura anterior. Este método reemplaza al método IGameInput::RegisterSystemButtonCallback de versiones anteriores de GameInput. Use IGameInput::RegisterReadingCallback con GameInputKindSystemButton, o sondee con IGameInput::GetCurrentReading, para recibir la entrada de los botones del sistema. La entrada de los botones del sistema solo se entrega mientras la aplicación tiene el foco, a menos que la entrada en segundo plano esté habilitada con IGameInput::EnableBackgroundInput. En el siguiente ejemplo se muestra cómo detectar una nueva pulsación del botón Guía.

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
IGameInputReading
GameInputSystemButtons
GameInputKind
IGameInput::EnableBackgroundInput
IGameInputDevice::GetSupportedSystemButtons

Historial de versiones

Última modificación el 6 de noviembre de 2026