Microsoft DirectX 8.0 (C++)

IDirectInputDevice8::Acquire

入力デバイスへのアクセス権を取得する。

HRESULT Acquire();

パラメータ

なし。

戻り値

成功した場合は、DI_OK を返す。デバイスが取得済みであれば S_FALSE を返す。

失敗した場合は、次のいずれかのエラー値を返す。

DIERR_INVALIDPARAM
DIERR_NOTINITIALIZED
DIERR_OTHERAPPHASPRIO

注意

デバイス取得の前に IDirectInputDevice8::SetDataFormat メソッドや IDirectInputDevice8::SetActionMap メソッドを使用して、データ形式を設定しなければならない。データ形式が設定されていない場合、AcquireDIERR_INVALIDPARAM を返す。

デバイスに対して IDirectInputDevice8::GetDeviceState または IDirectInputDevice8::GetDeviceData メソッドを呼び出す前に、そのデバイスを取得しておかなければならない。

デバイス取得では、参照カウントを使用しない。このため、アプリケーションが IDirectInputDevice8::Acquire メソッドを 2 回呼び出し、その後 IDirectInputDevice8::Unacquire メソッドを 1 回呼び出すと、デバイスは解放される。

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : dinput.h で宣言。