Méthode IDirectInputEffectDriver ::StartEffect (dinputd.h)

Article
02/26/2024

La méthode IDirectInputEffectDriver ::StartEffect commence la lecture d’un effet. Si l’effet est déjà en cours de lecture, il est redémarré dès le début.

Syntaxe

HRESULT StartEffect(
  DWORD unnamedParam1,
  DWORD unnamedParam2,
  DWORD unnamedParam3,
  DWORD unnamedParam4
);

Paramètres

unnamedParam1

Identifie le numéro de manette de jeu externe traité

unnamedParam2

Spécifie l’effet à lire.

unnamedParam3

Spécifie comment l’effet doit affecter d’autres effets. Seul le mode répertorié ci-dessous peut être utilisé ; tous les autres modes sont réservés. Par exemple, le pilote ne reçoit jamais l’indicateur DIES_NODOWNLOAD, car il est géré par DirectInput et non par le pilote. Ce paramètre peut être zéro, un ou plusieurs des indicateurs suivants :

DIES_SOLO

Indique que tous les autres effets sur l’appareil doivent être arrêtés avant la lecture de l’effet spécifié. Si cet indicateur est omis, l’effet est mélangé avec des effets existants qui ont déjà démarré sur l’appareil.

unnamedParam4

Spécifie le nombre de fois où effectuer l’effet. Si la valeur est INFINITE, l’effet doit être répété jusqu’à ce qu’il soit explicitement arrêté ou suspendu.

Valeur retournée

Retourne S_OK en cas de réussite ; sinon, retourne un code d’erreur.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dinputd.h (inclure Dinputd.h)

Partager via