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)