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

Статья
02/29/2024

Метод IDirectInputEffectDriver::StartEffect начинает воспроизведение эффекта. Если эффект уже воспроизводит, он перезапускается с самого начала.

Синтаксис

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

Параметры

unnamedParam1

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

unnamedParam2

Указывает воспроизводимый эффект.

unnamedParam3

Указывает, как эффект влияет на другие эффекты. Можно использовать только указанный ниже режим; все остальные режимы зарезервированы. Например, драйвер никогда не получает флаг DIES_NODOWNLOAD, так как он управляется DirectInput, а не драйвером. Этот параметр может быть равен нулю, одному или нескольким из следующих флагов:

DIES_SOLO

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

unnamedParam4

Указывает количество раз для выполнения эффекта. Если значение равно INFINITE, то эффект следует повторять до тех пор, пока не будет явно остановлен или приостановлен.

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

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

Требования

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

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