Platform SDK: DirectX

IDirectInputDevice7::Acquire

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 を使用。