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

Artigo
02/26/2024

O método IDirectInputEffectDriver::StartEffect inicia a reprodução de um efeito. Se o efeito já estiver sendo reproduzido, ele será reiniciado desde o início.

Sintaxe

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

Parâmetros

unnamedParam1

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

unnamedParam2

Especifica o efeito a ser reproduzido.

unnamedParam3

Especifica como o efeito deve afetar outros efeitos. Somente o modo listado abaixo pode ser usado; todos os outros modos são reservados. Por exemplo, o driver nunca recebe o sinalizador DIES_NODOWNLOAD porque é gerenciado pelo DirectInput e não pelo driver. Esse parâmetro pode ser zero, um ou mais dos seguintes sinalizadores:

DIES_SOLO

Indica que todos os outros efeitos no dispositivo devem ser interrompidos antes que o efeito especificado seja reproduzido. Se esse sinalizador for omitido, o efeito será misturado com os efeitos existentes que já foram iniciados no dispositivo.

unnamedParam4

Especifica o número de vezes para executar o efeito. Se o valor for INFINITE, o efeito deverá ser repetido até que seja interrompido ou pausado explicitamente.

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 (inclua Dinputd.h)

Compartilhar via