共用方式為

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 錯誤值：

傳回碼 Description
DIERR_NOTACQUIRED
尚未取得遊戲桿設定。 您必須先呼叫 IDirectInputJoyConfig8：：Acquire ，才能開啟遊戲桿類型組態機碼以進行寫入。
DIERR_INVALIDPARAM
一或多個參數無效。
MAKE_HRESULT (SEVERITY_ERROR、FACILITY_WIN32、ErrorCode)
如果登錄許可權或其他外部因素拒絕存取密鑰，則為 Win32 錯誤碼。

備註

控制面板應用程式可以使用此方法所開啟的登錄機碼來儲存每一類型的持續性資訊，例如全域組態參數。 這類私人信息應該保留在名為 OEM 的子機碼中;請勿將私用資訊儲存在主要類型金鑰中。 控制面板應用程式也可以使用此金鑰來讀取設定資訊，例如用於裝置校正提示的字串。 應用程式應該使用 RegCloseKey 來關閉登錄機碼。

規格需求

需求 值
目標平台 桌面
標頭 dinputd.h (包含 Dinputd.h)