Share via


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

El método IDirectInputEffectDriver::StartEffect comienza la reproducción de un efecto. Si el efecto ya se está reproduciendo, se reinicia desde el principio.

Sintaxis

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

Parámetros

unnamedParam1

Identifica el número de joystick externo que se está direccionando.

unnamedParam2

Especifica el efecto que se va a reproducir.

unnamedParam3

Especifica cómo afecta el efecto a otros efectos. Solo se puede usar el modo que se muestra a continuación; todos los demás modos están reservados. Por ejemplo, el controlador nunca recibe la marca de DIES_NODOWNLOAD porque está administrada por DirectInput y no por el controlador. Este parámetro puede ser cero, uno o varios de los siguientes marcadores:

DIES_SOLO

Indica que todos los demás efectos del dispositivo deben detenerse antes de que se reproduzca el efecto especificado. Si se omite esta marca, el efecto se mezcla con los efectos existentes que ya se han iniciado en el dispositivo.

unnamedParam4

Especifica el número de veces que se va a realizar el efecto. Si el valor es INFINITE, el efecto debe repetirse hasta que se detenga o se detenga explícitamente.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente; de lo contrario, devuelve un código de error.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dinputd.h (incluya Dinputd.h)