IDirectInputEffectDriver::StartEffect-Methode (dinputd.h)

Artikel
02/26/2024

Die IDirectInputEffectDriver::StartEffect-Methode beginnt mit der Wiedergabe eines Effekts. Wenn der Effekt bereits wiedergegeben wird, wird er von Anfang an neu gestartet.

Syntax

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

Parameter

unnamedParam1

Gibt die adressierte externe Joysticknummer an.

unnamedParam2

Gibt den effekt an, der wiedergegeben werden soll.

unnamedParam3

Gibt an, wie sich der Effekt auf andere Effekte auswirkt. Nur der unten aufgeführte Modus kann verwendet werden. alle anderen Modi sind reserviert. Der Treiber erhält beispielsweise nie das flag DIES_NODOWNLOAD, da es von DirectInput und nicht vom Treiber verwaltet wird. Dieser Parameter kann null, eins oder mehrere der folgenden Flags sein:

DIES_SOLO

Gibt an, dass alle anderen Effekte auf dem Gerät beendet werden sollen, bevor der angegebene Effekt wiedergegeben wird. Wenn dieses Flag weggelassen wird, wird der Effekt mit vorhandenen Effekten gemischt, die bereits auf dem Gerät gestartet wurden.

unnamedParam4

Gibt an, wie oft der Effekt ausgeführt werden soll. Wenn der Wert INFINITE ist, sollte der Effekt wiederholt werden, bis er explizit beendet oder angehalten wird.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Gibt andernfalls einen Fehlercode zurück.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dinputd.h (include Dinputd.h)

Share via