IDirectInputJoyConfig8::SetTypeInfo メソッド (dinputd.h)

  • [アーティクル]

IDirectInputJoyConfig8::SetTypeInfo メソッドは、新しいジョイスティックタイプを作成するか、既存のジョイスティックタイプに関する情報を再定義します。

構文

HRESULT SetTypeInfo(
  LPCWSTR          unnamedParam1,
  LPCDIJOYTYPEINFO unnamedParam2,
  DWORD            unnamedParam3,
  LPWSTR           unnamedParam4
);

パラメーター

unnamedParam1

型の名前をポイントします。 型の名前は、終端の null 文字を含め、MAX_JOYSTRING文字を超えることはできません。 型名がまだ存在しない場合は、作成されます。 定義済みの型の型情報を変更することはできません。 名前を "#" 文字で始めることはできません。 "#" で始まる型は DirectInput によって予約されています。

unnamedParam2

ジョイスティックの種類に関する情報を受け取る構造体を指します。

unnamedParam3

設定する値を含む pjti が指す DIJOYTYPEINFO 構造体の部分を指定します。

DITC_REGHWSETTINGS

ジョイスティックのレジストリ ハードウェア設定が有効であることを示します。

DITC_CLSIDCONFIG

ジョイスティック構成 CLSID が有効であることを示します。 値がすべてゼロの場合、このジョイスティックの種類に対するカスタム構成はありません。

DITC_DISPLAYNAME

ジョイスティックの種類の表示名が有効であることを示します。

DITC_CALLOUT

ジョイスティックの種類の吹き出しが有効であることを示します。

unnamedParam4

型名がVID_XXXX&PID_YYYY形式ではない OEM 型の場合、このパラメーターは Dinput によって割り当てられたVID_xxxx&PID_yyyy形式で名前を返します。 このVID_xxxx&PID_yyyy名は、SetConfig を呼び出すときに DIJOYCONFIG.wszType フィールドで使用する必要があります。

戻り値

成功した場合はDI_OKを返します。それ以外の場合は、次のいずれかの COM エラー値を返します。

リターン コード 説明
DIERR_NOTACQUIRED
ジョイスティックの構成が取得されていません。 ジョイスティック構成の変更をアプリケーションとドライバーに通知するには、 IDirectInputJoyConfig8::Acquire を呼び出す必要があります。
DIERR_INVALIDPARAM
1 つ以上のパラメーターが無効でした。
DIERR_READONLY
定義済みの型を変更しようとしました。

要件

   
対象プラットフォーム デスクトップ
Header dinputd.h (Dinputd.h を含む)