IDirectInputDevice8 インターフェイス
アプリケーションは IDirectInputDevice8 インターフェイスのメソッドを使用して、Microsoft DirectInput デバイスへのアクセスの獲得と解放、デバイスのプロパティと情報の管理、動作の設定、初期化の実行、フォース フィードバック エフェクトの作成と再生、およびデバイスのコントロール パネルの呼び出しを行います。
IDirectInputDevice8 のメンバー
| メソッド | 説明 |
|---|---|
| IDirectInputDevice8::Acquire | 入力デバイスへのアクセスを獲得します。 |
| IDirectInputDevice8::BuildActionMap | デバイスのアクション マップを作成し、その情報を取得します。 |
| IDirectInputDevice8::CreateEffect | エフェクトのグローバル一意識別子 (GUID) によって示されるエフェクトのインスタンスを作成し、初期化します。 |
| IDirectInputDevice8::EnumCreatedEffectObjects | このデバイスに対して現在作成済みのエフェクトをすべて列挙します。 |
| IDirectInputDevice8::EnumEffects | デバイス上のフォース フィードバック システムによってサポートされるエフェクトをすべて列挙します。 |
| IDirectInputDevice8::EnumEffectsInFile | フォース エディター ユーティリティ、または同じファイル フォーマットを使用する別のアプリケーションによって作成されたファイル内にある、すべてのエフェクトを列挙します。 |
| IDirectInputDevice8::EnumObjects | デバイス上で使用可能な入力オブジェクトと出力オブジェクトを列挙します。 |
| IDirectInputDevice8::Escape | フォース フィードバック ドライバーにハードウェア固有のコマンドを送ります。 |
| IDirectInputDevice8::GetCapabilities | DirectInputDevice オブジェクトの機能を取得します。 |
| IDirectInputDevice8::GetDeviceData | デバイスからバッファー データを取得します。 |
| IDirectInputDevice8::GetDeviceInfo | デバイスの識別に関する情報を取得します。 |
| IDirectInputDevice8::GetDeviceState | デバイスから即時データを取得します。 |
| IDirectInputDevice8::GetEffectInfo | エフェクトに関する情報を取得します。 |
| IDirectInputDevice8::GetForceFeedbackState | デバイスのフォース フィードバック システムの状態を取得します。 |
| IDirectInputDevice8::GetImageInfo | 構成プロパティ シート内で使用するデバイス イメージに関する情報を取得します。 |
| IDirectInputDevice8::GetObjectInfo | ボタンや軸など、デバイス オブジェクトに関する情報を取得します。 |
| IDirectInputDevice8::GetProperty | 入力デバイスに関する情報を取得します。 |
| IDirectInputDevice8::Initialize | DirectInputDevice オブジェクトを初期化します。 |
| IDirectInputDevice8::ポーリング | DirectInput デバイス上でポーリングされたオブジェクトからデータを取得します。 |
| IDirectInputDevice8::RunControlPanel | このデバイスに関連した DirectInput コントロール パネルを実行します。 |
| IDirectInputDevice8::SendDeviceData | 出力を受け入れるデバイスにデータを送信します。 |
| IDirectInputDevice8::SendForceFeedbackCommand | デバイスのフォース フィードバック システムにコマンドを送ります。 |
| IDirectInputDevice8::SetActionMap | デバイスのデータ フォーマットを設定し、アプリケーション定義のアクションをデバイス オブジェクトにマップします。 |
| IDirectInputDevice8::SetCooperativeLevel | デバイスのこのインスタンスに対して協調レベルを設定します。 |
| IDirectInputDevice8::SetDataFormat | DirectInput デバイスのデータ フォーマットを設定します。 |
| IDirectInputDevice8::SetEventNotification | デバイスの状態が変化したときに設定されるイベントを指定します。 |
| IDirectInputDevice8::SetProperty | デバイスの動作を定義するプロパティを設定します。 |
| IDirectInputDevice8::Unacquire | デバイスへのアクセスを解放します。 |
| IDirectInputDevice8::WriteEffectToFile | 1 つ以上のフォース フィードバック エフェクトに関する情報をファイルに保管します。このファイルは、EnumEffectsInFile を使用して読み取ることができます。 |
解説
IDirectInputDevice8 インターフェイスを取得するには、IDirectInput8::CreateDevice メソッドを使用します。例については、「DirectInput デバイスの作成」を参照してください。
IDirectInputDevice8 は、Microsoft DirectX の旧バージョンで使用されていた IDirectInputDevice、IDirectInputDevice2、および IDirectInputDevice7 の各インターフェイスを置き換えますが、これらのインターフェイスを継承していません。これらの旧インターフェイスと同じ名前を共有しているメソッドは類似したサービスを実行しますが、機能または動作がまったく同じとは限りません。QueryInterface を使用して、以前のインターフェイスを取得することはできません。
LPDIRECTINPUTDEVICE8 型は、IDirectInputDevice8 インターフェイスへのポインターとして次のように定義されます。
typedef struct IDirectInputDevice8 *LPDIRECTINPUTDEVICE8;