Platform SDK: DirectX |
ここでは、C++ でのアプリケーション開発について説明する。Visual Basic については、「DirectInput Visual Basic チュートリアル」を参照すること。
DirectInput システムのセットアップ手順の最初は、全体のマネージャとして単一の DirectInput オブジェクトを作成することである。これは、DirectInputCreateEx 関数を呼び出すことによって行う。
// HINSTANCE hinst; // 以前に初期化済み。 HRESULT hr; LPDIRECTINPUT7 g_lpdi; hr = DirectInputCreateEx(hinst, DIRECTINPUT_VERSION, IID_IDirectInput7, (void**)&g_lpdi, NULL); if FAILED(hr) { // DirectInput は利用可能ではない。適切な処置をとる。 }
DirectInputCreateEx の第 1 パラメータは、オブジェクトを作成するアプリケーションまたは DLL のインスタンス ハンドルである。
第 2 パラメータは、どのバージョンの DirectInput システムを DirectInput オブジェクトに使用するかを指示する。以前のバージョンの DirectInput と互換性のあるアプリケーションを設計することもできる。詳細については、「前のバージョンの DirectInput の設計」を参照すること。
第 3 パラメータは、どのインターフェイスが返されるかを指定する。ほとんどのアプリケーションは IID_IDirectInput7 を渡すことで、最新のバージョンを取得する。
第 4 パラメータは、この呼び出しが成功した場合に、有効なインターフェイス ポインタで初期化される変数のアドレスである。
最後のパラメータには、COM 集合化で使用する制御オブジェクトの IUnknown インターフェイスのアドレスを指定する。アプリケーションは、普通、集合化を使用しないので NULL を渡す。