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

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

  • Статья

Метод IDirectInputJoyConfig8::OpenTypeKey открывает раздел реестра, связанный с типом джойстика.

Синтаксис

HRESULT OpenTypeKey(
  LPCWSTR unnamedParam1,
  DWORD   unnamedParam2,
  PHKEY   unnamedParam3
);

Параметры

unnamedParam1

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

unnamedParam2

Задает маску доступа к системе безопасности реестра. Это может быть любое из значений, разрешенных функцией RegOpenKeyEx . Если запрашивается доступ на запись, сначала необходимо получить конфигурацию джойстика. Если запрашивается только доступ на чтение, приобретение не требуется.

unnamedParam3

Указывает на открытый раздел реестра при успешном выполнении.

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

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

Код возврата Описание
DIERR_NOTACQUIRED
Конфигурация джойстика не была получена. Прежде чем открывать ключ конфигурации типа джойстика для записи, необходимо вызвать IDirectInputJoyConfig8::Acquire .
DIERR_INVALIDPARAM
Один или несколько параметров были недопустимы.
MAKE_HRESULT(SEVERITY_ERROR, FACILITY_WIN32, ErrorCode)
Код ошибки Win32, если доступ к разделу запрещен разрешениями реестра или каким-либо другим внешним фактором.

Комментарии

Приложения панели управления могут использовать раздел реестра, открытый этим методом, для хранения постоянных сведений по типу, таких как глобальные параметры конфигурации. Такие личные сведения должны храниться в подразделе OEM; не храните личные сведения в ключе типа main. Приложения панели управления также могут использовать этот ключ для чтения сведений о конфигурации, таких как строки, используемые для запросов калибровки устройства. Приложение должно использовать RegCloseKey для закрытия раздела реестра.

Требования

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