Microsoft DirectX 8.0 (C++) |
DirectInputDevice オブジェクトを初期化する。IDirectInput8::CreateDevice メソッドは、デバイスの作成後、自動的にデバイスを初期化するので、アプリケーションは通常、このメソッドを呼び出す必要はない。
HRESULT Initialize( HINSTANCE hinst, DWORD dwVersion, REFGUID rguid );
DLL が親のアプリケーションのハンドルを渡すと、エラーとなる。たとえば、Web ページに埋め込まれていて DirectInput を使用する Microsoft ActiveX® コントロールは、Web ブラウザのハンドルではなく、それ自身のインスタンスのハンドルを渡さなければならない。これにより、DirectInput がそのコントロールを認識し、必要と思われる特別な動作をすべて有効にすることが確実になる。
成功した場合は、DI_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
DIERR_ACQUIRED |
DIERR_DEVICENOTREG |
S_FALSE が返されれば、rGUID を介して渡されたインスタンス GUID を持つデバイスは初期化済みである。
このメソッドが失敗する場合、基底のオブジェクトは不定の状態にあるものとみなし、使用前に再初期化しなければならない。
Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
ヘッダー : dinput.h で宣言。