XInputGetKeystroke
Recupera un evento de entrada del mando.Sintaxis
Parámetros
dwUserIndex _In_Tipo: DWORD Índice del jugador con sesión iniciada asociado al dispositivo. Un valor en el intervalo de 0 a XUSER_MAX_COUNT - 1; XUSER_INDEX_ANY se usa para capturar el siguiente evento de entrada disponible de cualquier usuario. dwReserved
Tipo: Reserved Este parámetro no se usa. pKeystroke _Out_
Tipo: XINPUT_KEYSTROKE* Puntero a una estructura XINPUT_KEYSTROKE que recibe un evento de entrada.
Valor devuelto
Tipo: DWORD- Si la función se ejecuta correctamente, devolverá ERROR_SUCCESS.
- Si no se han presionado teclas nuevas, la función devolverá ERROR_EMPTY.
- Si el mando no está conectado o el usuario no lo ha activado, la función devolverá ERROR_DEVICE_NOT_CONNECTED; consulte la sección Comentarios a continuación.
- Si la función da error, devolverá un código de error definido en Winerror.h.
Comentarios
Los mandos inalámbricos no se consideran activos al iniciarse el sistema; si se realiza una llamada a cualquiera de las funciones de XInput antes de que un mando inalámbrico esté activo, esa llamada devolverá ERROR_DEVICE_NOT_CONNECTED. Los títulos de juegos deben examinar el código devuelto y estar preparados para controlar esta condición. Los mandos con cable se activan automáticamente cuando se conectan. Los mandos inalámbricos se activan cuando el usuario presiona el botón START o el botón Guía para encender el mando. Si el código que va a portar de XInput a GameInput no llama a la función GetKeyStroke, puede reducir el tamaño del contenedor de XInput definiendo XINPUT_ON_GAMEINPUT_NO_XINPUTGETKEYSTROKE. Para obtener más información, consulte Portabilidad de XInput a GameInput.Requisitos
Encabezado: XInputOnGameInput.h Biblioteca: xgameruntime.lib Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX SeriesConsulte también
Portabilidad de XInput a GameInputXInputOnGameInput