IDirectInputJoyConfig8

IDirectInputJoyConfig8 インターフェイスは、プロパティ シートを作成するハードウェア開発者がレジストリに情報を書き込んだり、レジストリから情報を読み取ったりするためのメソッドを提供します。

IDirectInputJoyConfig8::Acquire メソッドは「ジョイスティック構成モード」を取得します。ジョイスティック構成モードに入れるアプリケーションは同時に 1 つのみで、他のアプリケーションがこのモードを取得しようとした場合はエラー DIERR_OTHERAPPHASPRIO が返されます。構成モードに入った後、アプリケーションはグローバルなジョイスティック構成設定を変更できます。その間に別のアプリケーションが設定を変更している可能性があるため、アプリケーションは新しい設定を適用する前に既存の設定を確認してください。

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

IDirectInputJoyConfig8::Unacquire メソッドは「ジョイスティック構成モード」を解放します。

成功した場合は DI_OK を返します。それ以外の場合は COM エラー コードを返します。

構成モードを解放する前に、アプリケーションは IDirectInputJoyConfig8::SendNotify を実行して、ジョイスティック構成の変更をすべてのデバイス ドライバーおよびアプリケーションに伝達します。構成の変更によって実質的な影響を受けるジョイスティックのインターフェイスを保持しているアプリケーションは、デバイスが再初期化されるまで DIERR_DEVICECHANGE エラー コードを受け取ります。実質的な構成変更の例としては、軸の数やボタンの数の変更が挙げられます。これに対して、デバイスのキャリブレーションの変更は DirectInput が内部で処理し、アプリケーションからは透過的です。

IDirectInputJoyConfig8::SetCooperativeLevel メソッドは、デバイスのインスタンスに対する協調レベルを設定します。IDirectInputJoyConfig8 インターフェイスでサポートされる協調レベルは DISCL_EXCLUSIVE と DISCL_BACKGROUND のみです。

成功した場合は DI_OK を返します。それ以外の場合は、次の COM エラー値を返します (この値は例示を目的としたものであり、必ずしも網羅的ではありません)。

IDirectInputJoyConfig8::SendNotify メソッドは、デバイス構成が変更されたことをデバイス ドライバーおよびアプリケーションに通知します。

成功した場合は DI_OK を返します。それ以外の場合は、次の COM エラー値を返します (この値は例示を目的としたものであり、必ずしも網羅的ではありません)。

IDirectInputJoyConfig8::EnumTypes メソッドは、現在 DirectInput がサポートしているジョイスティックの種類を列挙します。

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

このコールバックは、IDirectInputJoyConfig8::EnumTypes メソッドの呼び出しの結果として、DirectInput のジョイスティックの種類を受け取ります。

/*
パラメーター
pwszTypeName 
ジョイスティックの種類の名前を指します。種類名を格納するには MAX_JOYSTRING 文字のバッファーで十分です。種類名をエンド ユーザーに表示してはいけません。代わりに「表示名」を表示してください。ジョイスティックの種類の表示名を取得するには IDirectInputJoyConfig8::GetTypeInfo を使用します。シャープ記号 ("#") で始まる種類名は、変更も削除もできない定義済みの種類を表します。

pvRef 
IDirectInputJoyConfig8::EnumTypes メソッドで指定されたアプリケーション定義の値を指します。

戻り値
列挙を続行するには BOOL 値 DIENUM_CONTINUE を、列挙を停止するには DIENUM_STOP を返します。

*/


BOOL DIEnumJoyTypeProc(
   LPCWSTR pwszTypeName,
   LPVOID  pvRef
);
 

IDirectInputJoyConfig8::GetTypeInfo メソッドは、ジョイスティックの種類に関する情報を取得します。

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

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

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

IDirectInputJoyConfig8::DeleteType メソッドは、ジョイスティックの種類に関する情報を削除します。このメソッドは慎重に使用してください。削除した種類を参照するジョイスティックが存在しないことを保証するのは呼び出し元の責任です。

成功した場合は DI_OK を返します。それ以外の場合は、次のいずれかの COM エラー値を返します (これらの値は例示を目的としたものであり、必ずしも網羅的ではありません)。

IDirectInputJoyConfig8::GetConfig メソッドは、ジョイスティックの構成に関する情報を取得します。

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

IDirectInputJoyConfig8::SetConfig メソッドは、ジョイスティックの構成情報を作成または再定義します。

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

IDirectInputJoyConfig8::DeleteConfig メソッドは、ジョイスティックの構成情報を削除します。

成功した場合は DI_OK を返します。それ以外の場合は、次のいずれかの COM エラー値を返します (これらの値は例示を目的としたものであり、必ずしも網羅的ではありません)。

IDirectInputJoyConfig8::GetUserValues メソッドは、ジョイスティックのユーザー設定に関する情報を取得します。

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

IDirectInputJoyConfig8::SetUserValues メソッドは、ジョイスティックのユーザー設定を設定します。

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

IDirectInputJoyConfig8::AddNewHardware メソッドは、[ハードウェアの追加] ダイアログ ボックスを表示し、新しい入力デバイスのインストール手順をユーザーに案内します。

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

IDirectInputJoyConfig8::OpenTypeKey メソッドは、ジョイスティックの種類に関連付けられたレジストリ キーを開きます。

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

コントロール パネル アプリケーションは、このメソッドで開いたレジストリ キーを使用して、グローバル構成パラメーターなどの種類ごとの永続的な情報を保存できます。そのようなプライベートな情報は OEM という名前のサブキーに保存してください。メインの種類キーにプライベートな情報を保存しないでください。コントロール パネル アプリケーションは、デバイスのキャリブレーション用プロンプトに使用する文字列などの構成情報の読み取りにも、このキーを使用できます。アプリケーションは RegCloseKey を使用してレジストリ キーを閉じてください。

IDirectInputJoyConfig8::OpenAppStatusKey メソッドは、アプリケーション ステータス レジストリ キーのルート キーを開き、そのキーへのハンドルを出力パラメーターとして取得します。

成功した場合は DI_OK を返します。それ以外の場合は、次のいずれかの COM エラー値を返します。以下のエラー コードは例示を目的としたものであり、必ずしも網羅的ではありません。

phKey パラメーターで返されるレジストリ キー ハンドルは、標準の Win32 レジストリ関数で使用できます。Dinputd.h ヘッダー ファイルには、アプリケーション ステータスのルート キーに含まれるサブキーや名前付きの値にアクセスするための文字列定数が定義されています。