Compartir a través de

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

  • Artículo

El método IDirectInputEffectDriver::SendForceFeedbackCommand cambia el estado force-feedback del dispositivo.

Sintaxis

HRESULT SendForceFeedbackCommand(
  DWORD unnamedParam1,
  DWORD unnamedParam2
);

Parámetros

unnamedParam1

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

unnamedParam2

Indica cuál de los comandos siguientes se está enviando:

DISFFC_RESET

Indica que se debe detener la reproducción de cualquier efecto activo y que todos los efectos deben quitarse del dispositivo. Una vez restablecido el dispositivo, todos los efectos ya no son válidos y se deben volver a crear.

DISFFC_STOPALL

Indica que se debe detener la reproducción de todos los efectos. El envío del comando DISFFC_STOPALL equivale a invocar el método IDirectInputEffect::Stop en todos los efectos que se están reproduciendo. Si el dispositivo está en un estado en pausa, se permite que el controlador de dispositivo pierda el estado en pausa.

DISFFC_PAUSE

Indica que se debe pausar la reproducción de todos los efectos. Cuando se pausan los efectos, la hora "se detiene" hasta que se envía el comando DISFFC_CONTINUE. Por ejemplo, supongamos que se inicia un efecto de cinco segundos de duración. Después de un segundo, todos los efectos se pausan. Después de dos segundos más, se continúan todos los efectos. A continuación, el efecto debe reproducirse durante cuatro segundos adicionales. Mientras un dispositivo de respuesta forzada está en pausa, iniciar un nuevo efecto o modificar los existentes puede hacer que se pierda el estado en pausa.

DISFFC_CONTINUE

Indica que se debe reanudar la reproducción en el momento en el que se interrumpió para los efectos pausados por un comando de DISFFC_PAUSE anterior.

DISFFC_SETACTUATORSON

Indica que los accionadores de respuesta forzada del dispositivo deben estar habilitados.

DISFFC_SETACTUATORSOFF

Indica que los accionadores de respuesta forzada del dispositivo deben estar deshabilitados. Si se ejecuta correctamente, los efectos de forzar comentarios se "silencian". Tenga en cuenta que el tiempo continúa transcurriendo mientras los actuadores están apagados. Por ejemplo, supongamos que se inicia un efecto de duración de cinco segundos. Después de un segundo, se apagan los accionadores. Después de dos segundos más, los accionadores se vuelven a activar. A continuación, el efecto debe reproducirse durante dos segundos adicionales.

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)