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

Статья
08/23/2023

Метод IDirectInputJoyConfig8::SetTypeInfo создает новый тип джойстика или переопределяет сведения о существующем типе джойстика.

Синтаксис

HRESULT SetTypeInfo(
  LPCWSTR          unnamedParam1,
  LPCDIJOYTYPEINFO unnamedParam2,
  DWORD            unnamedParam3,
  LPWSTR           unnamedParam4
);

Параметры

unnamedParam1

Указывает на имя типа. Имя типа не может превышать MAX_JOYSTRING символов, включая завершающий символ NULL. Если имя типа еще не существует, оно создается. Невозможно изменить сведения о типе для предопределенного типа. Имя не может начинаться с символа "#". Типы, начинающие с "#", зарезервированы DirectInput.

unnamedParam2

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

unnamedParam3

Указывает части структуры DIJOYTYPEINFO , на которые указывает pjti , которые содержат устанавливаемые значения.

DITC_REGHWSETTINGS

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

DITC_CLSIDCONFIG

Указывает, что конфигурация джойстика ЯВЛЯЕТСЯ допустимой. Если значение равно нулю, пользовательская конфигурация для этого типа джойстика отсутствует.

DITC_DISPLAYNAME

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

DITC_CALLOUT

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

unnamedParam4

Если имя типа является типом OEM, не в VID_xxxx&PID_yyyy формате, этот параметр вернет имя в VID_xxxx&PID_yyyy формате, назначенном Dinput. Это имя VID_xxxx&PID_yyyy следует использовать в поле DIJOYCONFIG.wszType при вызове SetConfig.

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

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

Код возврата	Описание
DIERR_NOTACQUIRED	Конфигурация джойстика не была получена. Прежде чем вы сможете уведомлять приложения и драйверы об изменениях в конфигурации джойстика, необходимо вызвать IDirectInputJoyConfig8::Acquire .
DIERR_INVALIDPARAM	Один или несколько параметров были недопустимы.
DIERR_READONLY	Предпринята попытка изменить предопределенный тип.

Требования


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

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