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