Platform SDK: DirectX

IDirectInputDevice7::Escape

IDirectInputDevice7::Escape メソッドは、ハードウェア固有のコマンドをフォース フィードバック ドライバに送信する。

HRESULT Escape(
  LPDIEFFESCAPE pesc  
);

パラメータ

pesc
送信するコマンドを表す DIEFFESCAPE 構造体。成功すると、実際に使用する出力バッファのバイト数が cbOutBuffer メンバに格納される。

戻り値

成功すれば DI_OK を返す。

失敗すれば次のエラー値のいずれかを返す。

DIERR_DEVICEFULL
DIERR_NOTINITIALIZED

ほかのデバイス固有エラー コードを返すこともできる。ハードウェア メーカーから詳細情報を入手すること。

注意

各ドライバは、異なるエスケープ シーケンスを実装しているので、正しいドライバと通信しているかどうかは、アプリケーション自体が確認しなければならない。これは、DIDEVICEINSTANCE 構造体の guidFFDriver メンバと、アプリケーションが期待している値を比較することにより確認できる。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dinput.h で宣言。
  インポート ライブラリ : dinput.lib を使用。