Metodo IDirectInputEffectDriver::SendForceFeedbackCommand (dinputd.h)

Articolo
08/23/2023

Il metodo IDirectInputEffectDriver::SendForceFeedbackCommand modifica lo stato force-feedback per il dispositivo.

Sintassi

HRESULT SendForceFeedbackCommand(
  DWORD unnamedParam1,
  DWORD unnamedParam2
);

Parametri

unnamedParam1

Indica il numero di joystick esterno indirizzato.

unnamedParam2

Indica quale dei comandi seguenti viene inviato:

DISFFC_RESET

Indica che la riproduzione di tutti gli effetti attivi deve essere arrestata e che tutti gli effetti devono essere rimossi dal dispositivo. Dopo aver reimpostato il dispositivo, tutti gli effetti non sono più validi e devono essere ricreati.

DISFFC_STOPALL

Indica che la riproduzione di tutti gli effetti deve essere arrestata. L'invio del comando DISFFC_STOPALL equivale a richiamare il metodo IDirectInputEffect::Stop su tutti gli effetti che vengono riprodotti. Se il dispositivo si trova in uno stato sospeso, il driver del dispositivo può perdere lo stato sospeso.

DISFFC_PAUSE

Indica che la riproduzione di tutti gli effetti deve essere sospesa. Quando gli effetti vengono sospesi, ora "arresta" fino all'invio del comando DISFFC_CONTINUE. Si supponga, ad esempio, che venga avviato un effetto di cinque secondi. Dopo un secondo, tutti gli effetti vengono sospesi. Dopo due secondi, tutti gli effetti vengono continuati. L'effetto dovrebbe quindi essere riprodotto per quattro secondi aggiuntivi. Mentre un dispositivo force-feedback viene sospeso, l'avvio di un nuovo effetto o la modifica di quelli esistenti può causare la perdita dello stato sospeso.

DISFFC_CONTINUE

Indica che la riproduzione deve essere ripresa nel punto in cui è stata interrotta per tali effetti sospesi da un comando DISFFC_PAUSE precedente.

DISFFC_SETACTUATORSON

Indica che gli attuatori force-feedback del dispositivo devono essere abilitati.

DISFFC_SETACTUATORSOFF

Indica che gli attuatori force-feedback del dispositivo devono essere disabilitati. Se ha esito positivo, forzare gli effetti di feedback sono "disattivati". Si noti che il tempo continua a trascorrere mentre gli attuatori sono disattivati. Si supponga, ad esempio, che venga avviato un effetto della durata di cinque secondi. Dopo un secondo, gli attuatori vengono disattivati. Dopo due secondi, gli attuatori vengono riattivati. L'effetto dovrebbe quindi essere riprodotto per due secondi aggiuntivi.

Valore restituito

Restituisce S_OK se ha 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