Platform SDK: DirectX |
IDirectInputDevice7::Acquire メソッドは、入力デバイスへのアクセス権を取得する。
HRESULT Acquire();
なし。
成功すれば DI_OK または S_FALSE、
失敗すれば次のエラー値のいずれかを返す。
DIERR_INVALIDPARAM |
DIERR_NOTINITIALIZED |
DIERR_OTHERAPPHASPRIO |
S_FALSE が返された場合、デバイスは取得済みである。
デバイス取得の前に IDirectInputDevice7::SetDataFormat メソッドを使用して、データ形式を設定しなければならない。
デバイスに対して IDirectInputDevice7::GetDeviceState または IDirectInputDevice7::GetDeviceData メソッドを呼び出す前に、そのデバイスを取得しておかなければならない。
デバイス取得では、参照カウントを使用しない。このため、アプリケーションが IDirectInputDevice7::Acquire メソッドを 2 回呼び出し、その後 IDirectInputDevice7::Unacquire メソッドを 1 回呼び出すと、デバイスは解放される。
Windows NT/2000 :Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dinput.h で宣言。
インポート ライブラリ : dinput.lib を使用。