Метод IDirectInputEffectDriver::SendForceFeedbackCommand (dinputd.h)

Статья
08/23/2023

Метод IDirectInputEffectDriver::SendForceFeedbackCommand изменяет состояние принудительной обратной связи для устройства.

Синтаксис

HRESULT SendForceFeedbackCommand(
  DWORD unnamedParam1,
  DWORD unnamedParam2
);

Параметры

unnamedParam1

Указывает номер внешнего джойстика, для которых выполняется обращение.

unnamedParam2

Указывает, какая из следующих команд отправляется:

DISFFC_RESET

Указывает, что воспроизведение любых активных эффектов должно быть остановлено и что все эффекты должны быть удалены с устройства. После сброса устройства все эффекты становятся недействительными и должны быть созданы заново.

DISFFC_STOPALL

Указывает, что воспроизведение всех эффектов должно быть остановлено. Отправка команды DISFFC_STOPALL эквивалентна вызову метода IDirectInputEffect::Stop для всех воспроизводимых эффектов. Если устройство находится в приостановленном состоянии, драйверу устройства разрешено потерять приостановленное состояние.

DISFFC_PAUSE

Указывает, что воспроизведение всех эффектов должно быть приостановлено. При приостановке эффектов время "останавливается", пока не будет отправлена команда DISFFC_CONTINUE. Например, предположим, что начинается эффект продолжительности в пять секунд. Через одну секунду все эффекты приостанавливаются. Еще через две секунды все эффекты продолжаются. Затем эффект должен воспроизводиться в течение четырех дополнительных секунд. Пока устройство принудительной обратной связи приостановлено, запуск нового эффекта или изменение существующих может привести к потере приостановленного состояния.

DISFFC_CONTINUE

Указывает, что воспроизведение должно быть возобновлено в момент, когда оно было прервано для тех эффектов, которые были приостановлены предыдущей командой DISFFC_PAUSE.

DISFFC_SETACTUATORSON

Указывает, что должны быть включены приводы принудительной обратной связи устройства.

DISFFC_SETACTUATORSOFF

Указывает, что приводы принудительной обратной связи устройства должны быть отключены. В случае успешного выполнения эффекты принудительной обратной связи будут отключены. Обратите внимание, что время продолжает истечь, пока выключены приводы. Например, предположим, что начинается эффект продолжительности в пять секунд. Через одну секунду приводы отключаются. Еще через две секунды приводы снова включены. Затем эффект должен воспроизводиться в течение двух дополнительных секунд.

Возвращаемое значение

Возвращает S_OK в случае успешного выполнения; в противном случае возвращает код ошибки.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	dinputd.h (включая Dinputd.h)

Поделиться через