IDirectInputJoyConfig8::OpenTypeKey メソッド (dinputd.h)
IDirectInputJoyConfig8::OpenTypeKey メソッドは、ジョイスティックの種類に関連付けられているレジストリ キーを開きます。
構文
HRESULT OpenTypeKey(
LPCWSTR unnamedParam1,
DWORD unnamedParam2,
PHKEY unnamedParam3
);
パラメーター
unnamedParam1
型の名前をポイントします。 型の名前は、終端の null 文字を含め、MAX_PATH文字を超えることはできません。 名前を "#" 文字で始めることはできません。 "#" で始まる型は、DirectInput によって予約されます。
unnamedParam2
レジストリ セキュリティ アクセス マスクを指定します。 これは、 RegOpenKeyEx 関数で許可される任意の値を指定できます。 書き込みアクセスが要求された場合は、ジョイスティック構成が最初に取得されている必要があります。 読み取りアクセスのみが要求された場合、取得は必要ありません。
unnamedParam3
成功した場合は、開いているレジストリ キーをポイントします。
戻り値
成功した場合はDI_OKを返します。それ以外の場合は、次のいずれかの COM エラー値を返します。
リターン コード | 説明 |
---|---|
|
ジョイスティックの構成が取得されていません。 書き込み用のジョイスティック型構成キーを開くには、 IDirectInputJoyConfig8::Acquire を呼び出す必要があります。 |
|
1 つ以上のパラメーターが無効でした。 |
|
レジストリのアクセス許可またはその他の外部要素によってキーへのアクセスが拒否された場合の Win32 エラー コード。 |
注釈
コントロール パネル アプリケーションでは、このメソッドによって開かれたレジストリ キーを使用して、グローバル構成パラメーターなどの型ごとの永続的な情報を格納できます。 このような個人情報は、OEM という名前のサブキーに保持する必要があります。メイン型キーに秘密情報を格納しないでください。 コントロール パネル アプリケーションでは、このキーを使用して、デバイスの調整プロンプトに使用する文字列などの構成情報を読み取ることもできます。 レジストリ キーを閉じるには、アプリケーションで RegCloseKey を使用する必要があります。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | dinputd.h (Dinputd.h を含む) |