Metode IDirectInputJoyConfig8::AddNewHardware (dinputd.h)

Metode IDirectInputJoyConfig8::AddNewHardware menampilkan kotak dialog Tambahkan Perangkat Keras Baru yang memandu pengguna menginstal perangkat input baru.

Sintaks

HRESULT AddNewHardware(
  HWND    unnamedParam1,
  REFGUID unnamedParam2
);

Parameter

unnamedParam1

Tangani ke jendela yang berfungsi sebagai jendela pemilik untuk antarmuka pengguna.

unnamedParam2

GUID yang menentukan kelas perangkat keras yang akan ditambahkan. DirectInput dilengkapi dengan GUID kelas berikut yang sudah ditentukan:

GUID_KeyboardClass

Perangkat keyboard.

GUID_MouseClass

Perangkat tetikus.

GUID_MediaClass

Perangkat media, termasuk joystick.

GUID_HIDClass

Perangkat HID.

Nilai kembali

Mengembalikan DI_OK jika berhasil; jika tidak, mengembalikan salah satu nilai kesalahan COM berikut:

Menampilkan kode Deskripsi
DIERR_INVALIDPARAM
(E_INVALIDARG). Satu atau beberapa parameter tidak valid.
DIERR_INVALIDCLASSINSTALLER
Penginstal kelas untuk perangkat yang ditentukan tidak dapat ditemukan atau tidak valid.
DIERR_CANCELLED
Pengguna membatalkan operasi.
DIERR_BADINF
File INF untuk perangkat yang dipilih pengguna tidak dapat ditemukan atau tidak valid atau rusak.
S_FALSE
DirectInput tidak dapat menentukan apakah operasi berhasil diselesaikan.

Persyaratan

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