Microsoft DirectX 8.0 (C++)

IDirectInputDevice8

アプリケーションは、IDirectInputDevice8 インターフェイスのメソッドを使用して、Microsoft® DirectInput® デバイスのアクセス権の取得と解放、デバイス プロパティと情報の管理、動作の設定、初期化の実行、フォース フィードバック エフェクトの生成と再生、およびデバイスのコントロール パネルの起動を行う。

IDirectInput8 インターフェイスは IDirectInput8::CreateDevice メソッドを使用して取得する。例については、「DirectInput デバイスの作成」を参照すること。

IDirectInputDevice8 は、これまでのバージョンの Microsoft® DirectX® で使用されていた IDirectInputDeviceIDirectInputDevice2、および IDirectInputDevice7 に取って代わるインターフェイスであるが、それらから継承はしない。以前のインターフェイスのメソッドと同名のメソッドは同様のサービスを実行するが、機能や動作がまったく同じであるとは限らない。QueryInterface を使って以前のインターフェイスを取得することはできない。

IDirectInputDevice8 インターフェイスのメソッドは、以下のグループにまとめることができる。

入力デバイスのアクセス Acquire
  Unacquire
アクション マッピング BuildActionMap
  GetImageInfo
SetActionMap
デバイス情報 GetCapabilities
  GetDeviceData
GetDeviceInfo
GetDeviceState
Poll
SetDataFormat
SetEventNotification
デバイス オブジェクト EnumObjects
  GetObjectInfo
デバイス プロパティ GetProperty
  SetCooperativeLevel
SetProperty
フォース フィードバック CreateEffect
  EnumCreatedEffectObjects
EnumEffects
EnumEffectsInFile
Escape
GetEffectInfo
GetForceFeedbackState
SendForceFeedbackCommand
WriteEffectToFile
その他 Initialize
  RunControlPanel
SendDeviceData

すべての COM インターフェイスと同様に、IDirectInputDevice8 インターフェイスは IUnknown インターフェイス メソッドを継承する。IUnknown インターフェイスは、以下の 3 つのメソッドをサポートする。

IUnknown AddRef
  QueryInterface
Release

LPDIRECTINPUTDEVICE8 型は IDirectInputDevice8 インターフェイスへのポインタとして定義される。

typedef struct IDirectInputDevice8    *LPDIRECTINPUTDEVICE8;

動作環境

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

参照

IDirectInputDevice8