Metodo IDirectInputEffectDriver::StartEffect (dinputd.h)

Articolo
02/26/2024

Il metodo IDirectInputEffectDriver::StartEffect inizia la riproduzione di un effetto. Se l'effetto è già in riproduzione, viene riavviato dall'inizio.

Sintassi

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

Parametri

unnamedParam1

Identifica il numero di joystick esterno da indirizzare

unnamedParam2

Specifica l'effetto da riprodurre.

unnamedParam3

Specifica il modo in cui l'effetto deve influire su altri effetti. È possibile usare solo la modalità elencata di seguito; tutte le altre modalità sono riservate. Ad esempio, il driver non riceve mai il flag DIES_NODOWNLOAD perché è gestito da DirectInput e non dal driver. Questo parametro può essere zero, uno o più dei flag seguenti:

DIES_SOLO

Indica che tutti gli altri effetti sul dispositivo devono essere arrestati prima che venga riprodotto l'effetto specificato. Se questo flag viene omesso, l'effetto viene combinato con gli effetti esistenti che sono già stati avviati nel dispositivo.

unnamedParam4

Specifica il numero di volte in cui eseguire l'effetto. Se il valore è INFINITE, l'effetto deve essere ripetuto fino a quando non viene arrestato o sospeso in modo esplicito.

Valore restituito

Restituisce S_OK in caso di esito positivo; in caso contrario, restituisce un codice di errore.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dinputd.h (include Dinputd.h)

Condividi tramite