IDirectInputDevice8::Initialize
DirectInputDevice オブジェクトを初期化します。IDirectInput8::CreateDevice メソッドは、デバイスを作成後に自動的に初期化します。通常、アプリケーションがこのメソッドを呼び出す必要はありません。
HRESULT
Initialize(
HINSTANCE hinst,
DWORD dwVersion,
REFGUID rguid
);
パラメータ
- hinst
DirectInputDevice オブジェクトを作成するアプリケーションまたはダイナミック リンク ライブラリ (DLL) のインスタンス ハンドル。DirectInput は、この値を使用してアプリケーションまたは DLL が認証されているかどうか判別し、後方互換性のために必要な特殊動作があれば設定します。DLL が親アプリケーションのハンドルを渡すとエラーになります。たとえば、DirectInput を使用する Web ページに組み込まれた Microsoft ActiveX コントロールは、ブラウザーのハンドルではなくコントロール自身のインスタンス ハンドルを渡す必要があります。これにより、DirectInput がコントロールを認識でき、必要な特殊動作があればその動作を有効にできます。 - dwVersion
アプリケーションが設計された対象の DirectInput のバージョン番号。この値は通常は DIRECTINPUT_VERSION です。前のバージョンのバージョン番号を渡すと、DirectInput はそのバージョンをエミュレートします。 - rguid
インターフェイスを関連付けるデバイスのインスタンスを示すグローバル一意識別子 (GUID) の参照 (C++)、またはアドレス (C)。IDirectInput8::EnumDevices メソッドを使用して、システムがサポートするインスタンス GUID を判別できます。
戻り値
メソッドが正常に実行された場合、戻り値は DI_OK または S_FALSE です。メソッドが S_FALSE を返す場合は、rGUID によって渡されたインスタンス GUID によってデバイスは既に初期化されています。メソッドが失敗した場合、戻り値は次のいずれかのエラー値です。DIERR_ACQUIRED、DIERR_DEVICENOTREG
解説
このメソッドが失敗した場合は、基礎となるオブジェクトは不確定な状態にあると考えられるので、使用する前に再初期化が必要です。
要件
ヘッダー: Dinput.h 宣言