Metode IDirectInputEffectDriver::StartEffect (dinputd.h)

Artikel
02/26/2024

Metode IDirectInputEffectDriver::StartEffect memulai pemutaran efek. Jika efek sudah diputar, efek dimulai ulang dari awal.

Sintaks

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

Parameter

unnamedParam1

Mengidentifikasi nomor joystick eksternal yang sedang ditangani

unnamedParam2

Menentukan efek yang akan dimainkan.

unnamedParam3

Menentukan bagaimana efeknya mempengaruhi efek lain. Hanya mode yang tercantum di bawah ini yang dapat digunakan; semua mode lainnya dicadangkan. Misalnya, driver tidak pernah menerima bendera DIES_NODOWNLOAD karena dikelola oleh DirectInput dan bukan driver. Parameter ini bisa nol, satu, atau beberapa bendera berikut:

DIES_SOLO

Menunjukkan bahwa semua efek lain pada perangkat harus dihentikan sebelum efek yang ditentukan diputar. Jika bendera ini dihilangkan, efeknya dicampur dengan efek yang ada yang telah dimulai pada perangkat.

unnamedParam4

Menentukan berapa kali efek dilakukan. Jika nilainya ADALAH INFINITE, maka efeknya harus diulang hingga secara eksplisit dihentikan atau dijeda.

Nilai kembali

Mengembalikan S_OK jika berhasil; jika tidak, mengembalikan kode kesalahan.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	dinputd.h (termasuk Dinputd.h)