Passer au contenu principal
Récupère des informations sur les moteurs de retour de force du périphérique, comme les axes et les types d’effets qu’ils prennent en charge.

Syntaxe

Paramètres

infoArrayCount   _In_
Type : uint32_t
Nombre d’éléments de infoArray. Pour récupérer tous les moteurs de retour de force, transmettez la valeur retournée par GetForceFeedbackMotorCount. infoArray   _Out_writes_to_opt_(infoArrayCount, return)
Type : GameInputForceFeedbackMotorInfo*
Pointeur vers un tableau qui reçoit une structure par moteur de retour de force. Peut être nullptr, auquel cas rien n’est écrit et la méthode retourne 0.

Valeur de retour

Type : uint32_t Nombre d’éléments écrits dans infoArray. Il s’agit de la plus petite valeur entre infoArrayCount et le nombre de moteurs de retour de force du périphérique, ou de 0 si infoArray est nullptr ou si le périphérique n’a aucun moteur de retour de force.

Remarques

Chaque élément est une structure GameInputForceFeedbackMotorInfo qui décrit les axes actionnés par le moteur correspondant et les types d’effets de retour de force qu’il prend en charge. Appelez GetForceFeedbackMotorCount pour obtenir le nombre de moteurs de retour de force, allouez un tableau de cette taille, puis appelez GetForceFeedbackMotorInfo pour le remplir. Si infoArrayCount est inférieur au nombre de moteurs de retour de force, seuls les infoArrayCount premiers éléments sont écrits. Les moteurs de retour de force d’un périphérique ne changent pas tant que le périphérique est connecté ; vous pouvez donc les interroger une seule fois et mettre le résultat en cache. L’élément i du tableau d’informations décrit le moteur dont l’index de moteur est i. Utilisez cet index comme paramètre motorIndex de CreateForceFeedbackEffect, IsForceFeedbackMotorPoweredOn et SetForceFeedbackMotorGain. L’exemple suivant montre comment récupérer les moteurs de retour de force d’un périphérique.
Dans GameInput v3 et les versions antérieures, ces informations étaient disponibles via le membre forceFeedbackMotorInfo de la structure GameInputDeviceInfo retournée par IGameInputDevice::GetDeviceInfo.

Configuration requise

En-tête : GameInput.h Bibliothèque : gameinput.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

Vue d’ensemble de GameInput
GetForceFeedbackMotorCount
GameInputForceFeedbackMotorInfo
CreateForceFeedbackEffect
IsForceFeedbackMotorPoweredOn
SetForceFeedbackMotorGain
Retour de force dans GameInput
IGameInputDevice

Historique des versions

Dernière modification le 6 novembre 2026