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 conGAMEINPUT_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 SeriesConsulte también
Miembros de la API de GameInput en desusoIGameInputReading::GetSystemButtonState
Temas avanzados de GameInput
Información general de GameInput
IGameInput
