Método IDirectInputEffectDriver::SendForceFeedbackCommand (dinputd.h)

Artigo
08/23/2023

O método IDirectInputEffectDriver::SendForceFeedbackCommand altera o estado force-feedback para o dispositivo.

Sintaxe

HRESULT SendForceFeedbackCommand(
  DWORD unnamedParam1,
  DWORD unnamedParam2
);

Parâmetros

unnamedParam1

Indica o número do joystick externo que está sendo endereçado.

unnamedParam2

Indica quais dos seguintes comandos estão sendo enviados:

DISFFC_RESET

Indica que a reprodução de quaisquer efeitos ativos deve ser interrompida e que todos os efeitos devem ser removidos do dispositivo. Depois que o dispositivo tiver sido redefinido, todos os efeitos não serão mais válidos e deverão ser recriados.

DISFFC_STOPALL

Indica que a reprodução de todos os efeitos deve ser interrompida. Enviar o comando DISFFC_STOPALL é equivalente a invocar o método IDirectInputEffect::Stop em todos os efeitos que estão sendo reproduzidas. Se o dispositivo estiver em estado de pausa, o driver do dispositivo terá permissão para perder o estado em pausa.

DISFFC_PAUSE

Indica que a reprodução de todos os efeitos deve ser pausada. Quando os efeitos são pausados, o tempo "para" até que o comando DISFFC_CONTINUE seja enviado. Por exemplo, suponha que um efeito de cinco segundos de duração seja iniciado. Após um segundo, todos os efeitos são pausados. Depois de mais dois segundos, todos os efeitos são continuados. Em seguida, o efeito deve ser reproduzido por quatro segundos adicionais. Enquanto um dispositivo de force-feedback é pausado, iniciar um novo efeito ou modificar os existentes pode fazer com que o estado em pausa seja perdido.

DISFFC_CONTINUE

Indica que a reprodução deve ser retomada no ponto em que foi interrompida para os efeitos que foram pausados por um comando DISFFC_PAUSE anterior.

DISFFC_SETACTUATORSON

Indica que os atuadores de force-feedback do dispositivo devem ser habilitados.

DISFFC_SETACTUATORSOFF

Indica que os atuadores de force-feedback do dispositivo devem ser desabilitados. Se tiver êxito, os efeitos de force feedback serão "ativados". Observe que o tempo continua decorrido enquanto os atuadores estão desativados. Por exemplo, suponha que um efeito de duração de cinco segundos seja iniciado. Após um segundo, os atuadores são desativados. Após mais dois segundos, os atuadores são ativados novamente. Em seguida, o efeito deve ser reproduzido por dois segundos adicionais.

Retornar valor

Retorna S_OK se tiver êxito; caso contrário, retorna um código de erro.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	dinputd.h (include Dinputd.h)

Compartilhar via