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

Статья
08/23/2023

Метод IDirectInputJoyConfig8::GetConfig получает сведения о конфигурации джойстика.

Синтаксис

HRESULT GetConfig(
  UINT          unnamedParam1,
  LPDIJOYCONFIG unnamedParam2,
  DWORD         unnamedParam3
);

Параметры

unnamedParam1

Указывает идентификационный номер джойстика. Это неотрицательное целое число. Чтобы перечислить джойстики, начните с нуля и увеличиваете число джойстика на единицу, пока функция не вернет DIERR_NOMOREITEMS.

unnamedParam2

Указывает на структуру, которая получает сведения о конфигурации джойстика. Вызывающий объект "должен" инициализировать член dwSize структуры DIJOYCONFIG перед вызовом этого метода.

unnamedParam3

Указывает элементы структуры, на которые указывает pjc , которые должны быть заполнены. Этот параметр может быть равен нулю, одному или нескольким из следующих значений:

DIJC_GUIDINSTANCE

Указывает, что запрашивается GUID экземпляра для джойстика. Приложение может передать GUID экземпляра в IDirectInput::CreateDevice , чтобы получить интерфейс IDirectInputDevice в джойстик. Обратите внимание, что этот флаг не является допустимым параметром для IDirectInputJoyConfig8::SetConfig.

DIJC_REGHWCONFIGTYPE

Указывает, что запрашивается конфигурация оборудования для джойстика (член hwc структуры DIJOYCONFIG) и имя типа джойстика (член wszType той же структуры). Обратите внимание, что конфигурацию оборудования и имя типа нельзя получить отдельно.

DIJC_GAIN

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

DIJC_CALLOUT

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

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

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

Код возврата	Описание
DIERR_INVALIDPARAM	Один или несколько параметров были недопустимы.
S_FALSE	Указанный джойстик еще не настроен.
DIERR_NOMOREITEMS	Джойстики больше не доступны.

Требования

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

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