Saltar al contenido principal
En desuso. Este método se quitó en GameInput v4 y no está disponible en la API actual. En su lugar, lea el estado de los botones del sistema a partir de las lecturas de entrada con IGameInputReading::GetSystemButtonState y GameInputKindSystemButton.
Registra una función de devolución de llamada a la que se llama cuando se presiona o se suelta el botón Guía o Compartir.

Sintaxis

Parámetros

device   _In_opt_
Tipo: IGameInputDevice*
Opcionalmente, limita la devolución de llamada registrada para que se desencadene con un dispositivo específico. buttonFilter   _In_
Tipo: GameInputSystemButtons
El conjunto de botones para los que se recibirán devoluciones de llamada, combinados con un OR lógico. context   _In_opt_
Tipo: void*
Un objeto que proporciona información pertinente para la función de devolución de llamada. Normalmente, es el objeto que realiza la llamada. callbackFunc   _In_
Tipo: GameInputSystemButtonCallback
Función de devolución de llamada definida por el título a la que se llama cuando se presionan o se sueltan los botones del sistema. callbackToken   _Out_opt_
Tipo: GameInputCallbackToken*
Token que identifica la función de devolución de llamada registrada. Este token se usa para identificar la función registrada si necesita cancelar o anular el registro de la función de devolución de llamada.

Valor devuelto

Tipo: HRESULT Resultado de la función.

Comentarios

Este método registra una función de devolución de llamada a la que se llama cuando se presiona o se suelta el botón Guía o Sistema. Que se envíen o no las devoluciones de llamada depende de la GameInputFocusPolicy establecida por IGameInput::SetFocusPolicy en su proceso y en otros procesos. Consulte GameInputFocusPolicy para obtener más detalles. En XBOX, el shell siempre consume el botón Guía, por lo que estas devoluciones de llamada nunca se envían en XBOX. En PC, cuando el runtime de GameInput se carga localmente con la aplicación en lugar de instalarse en el sistema, este método produce un error con GAMEINPUT_E_FEATURE_REQUIRES_INSTALL (0x838AD02B). Para obtener más información, consulte Carga local (sideloading) de GameInput. Para dejar de recibir devoluciones de llamada, consulte los métodos IGameInput::UnregisterCallback e IGameInput::StopCallback. Se agregó en el archivo GameInput.h de la versión preliminar 10.0.26031 de Windows SDK y se agregará en una versión futura del GDK. En el siguiente ejemplo de código se muestra cómo escuchar las pulsaciones 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

Miembros de la API de GameInput en desuso
IGameInputReading::GetSystemButtonState
Temas avanzados de GameInput
Información general de GameInput
IGameInput

Historial de versiones

Última modificación el 6 de noviembre de 2026