Метод IDirectInputJoyConfig8::AddNewHardware (dinputd.h)

Статья
02/26/2024

Метод IDirectInputJoyConfig8::AddNewHardware отображает диалоговое окно Добавление нового оборудования , которое поможет пользователю установить новое устройство ввода.

Синтаксис

HRESULT AddNewHardware(
  HWND    unnamedParam1,
  REFGUID unnamedParam2
);

Параметры

unnamedParam1

Дескриптор к окну, которое функционирует как окно владельца для пользовательского интерфейса.

unnamedParam2

GUID, указывающий класс добавляемого аппаратного устройства. DirectInput поставляется со следующими идентификаторами GUID класса, которые уже определены:

GUID_KeyboardClass

Клавиатурные устройства.

GUID_MouseClass

Устройства с мышью.

GUID_MediaClass

Устройства мультимедиа, включая джойстики.

GUID_HIDClass

Устройства HID.

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

Возвращает DI_OK в случае успешного выполнения; В противном случае возвращает одно из следующих значений ошибки COM:

Код возврата	Описание
DIERR_INVALIDPARAM	(E_INVALIDARG). Один или несколько параметров были недопустимы.
DIERR_INVALIDCLASSINSTALLER	Не удалось найти установщик класса для указанного устройства или он недопустим.
DIERR_CANCELLED	Пользователь отменил операцию.
DIERR_BADINF	Не удалось найти INF-файл для выбранного пользователем устройства, является недопустимым или поврежденным.
S_FALSE	DirectInput не удалось определить, успешно ли выполнена операция.

Требования

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

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