Saltar al contenido principal
Recupera las propiedades de volante de carreras del dispositivo, como las etiquetas de sus controles, los pedales, la palanca de cambios y el ángulo máximo del volante.

Sintaxis

Parámetros

info   _Out_
Tipo: GameInputRacingWheelInfo*
Puntero a una estructura GameInputRacingWheelInfo que recibe las propiedades de volante de carreras del dispositivo. Si el dispositivo no admite la entrada de volante de carreras, todos los miembros de la estructura se establecen en cero.

Valor devuelto

Tipo: bool true si el dispositivo admite la entrada de volante de carreras y se rellenó info; de lo contrario, false.

Comentarios

El método GetRacingWheelInfo copia las propiedades de volante de carreras del dispositivo en la estructura proporcionada por el autor de la llamada. Un dispositivo admite la entrada de volante de carreras cuando el valor devuelto por GetSupportedInput incluye GameInputKindRacingWheel. Si el dispositivo no admite la entrada de volante de carreras, GetRacingWheelInfo inicializa info con ceros y devuelve false. Los miembros hasClutch, hasHandbrake y hasPatternShifter indican qué controles opcionales están presentes, minPatternShifterGear y maxPatternShifterGear indican el intervalo de marchas de la palanca de cambios en H, y maxWheelAngle indica la rotación máxima del volante. Los miembros de etiqueta describen las marcas impresas en los controles correspondientes, como valores de GameInputLabel, para que pueda mostrar indicaciones coincidentes en la interfaz de usuario. Los miembros extraButtonCount y extraAxisCount indican cuántos botones y ejes de mando tiene el dispositivo además de la asignación estándar de volante de carreras; use GetExtraButtonIndexes y GetExtraAxisIndexes para localizarlos en el estado del mando de una lectura. El estado del volante de carreras se lee de las lecturas mediante IGameInputReading::GetRacingWheelState. Las propiedades que devuelve este método son fijas durante la vida útil del dispositivo, por lo que puede consultarlas una vez (por ejemplo, cuando se conecta el dispositivo) y almacenar en caché el resultado. En el siguiente ejemplo se muestra cómo consultar las propiedades de volante de carreras de un dispositivo.
En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro racingWheelInfo 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
GameInputRacingWheelInfo
GetSupportedInput
GameInputKind
GameInputLabel
IGameInputReading::GetRacingWheelState
IGameInputDevice

Historial de versiones

Última modificación el 6 de noviembre de 2026