Saltar al contenido principal
Recupera información sobre los motores de retroalimentación de fuerza del dispositivo, como los ejes y los tipos de efecto que admiten.

Sintaxis

Parámetros

infoArrayCount   _In_
Tipo: uint32_t
Número de elementos de infoArray. Para recuperar todos los motores de retroalimentación de fuerza, pase el valor devuelto por GetForceFeedbackMotorCount. infoArray   _Out_writes_to_opt_(infoArrayCount, return)
Tipo: GameInputForceFeedbackMotorInfo*
Puntero a una matriz que recibe una estructura por cada motor de retroalimentación de fuerza. Puede ser nullptr, en cuyo caso no se escribe nada y el método devuelve 0.

Valor devuelto

Tipo: uint32_t El número de elementos escritos en infoArray. Es el menor de infoArrayCount y el número de motores de retroalimentación de fuerza del dispositivo, o 0 si infoArray es nullptr o el dispositivo no tiene motores de retroalimentación de fuerza.

Comentarios

Cada elemento es una estructura GameInputForceFeedbackMotorInfo que describe los ejes que acciona el motor correspondiente y los tipos de efecto de retroalimentación de fuerza que admite. Llame a GetForceFeedbackMotorCount para obtener el número de motores de retroalimentación de fuerza, asigne una matriz de ese tamaño y, a continuación, llame a GetForceFeedbackMotorInfo para rellenarla. Si infoArrayCount es menor que el número de motores de retroalimentación de fuerza, solo se escriben los primeros infoArrayCount elementos. Los motores de retroalimentación de fuerza de un dispositivo no cambian mientras el dispositivo está conectado, por lo que puede consultarlos una vez y almacenar en caché el resultado. El elemento i de la matriz de información describe el motor que tiene el índice de motor i. Use ese índice como parámetro motorIndex de CreateForceFeedbackEffect, IsForceFeedbackMotorPoweredOn y SetForceFeedbackMotorGain. En el siguiente ejemplo se muestra cómo recuperar los motores de retroalimentación de fuerza de un dispositivo.
En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro forceFeedbackMotorInfo 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
GetForceFeedbackMotorCount
GameInputForceFeedbackMotorInfo
CreateForceFeedbackEffect
IsForceFeedbackMotorPoweredOn
SetForceFeedbackMotorGain
Retroalimentación de fuerza en GameInput
IGameInputDevice

Historial de versiones

Última modificación el 6 de noviembre de 2026