Microsoft DirectX 8.0 (Visual Basic)

DirectInputDevice8.CreateEffectFromFile

フォース フィードバック エフェクトを作成し、そのパラメータをファイルに保存する。デバイスが現在排他協調レベルで取得されている場合、エフェクトのダウンロードも行われる。

object.CreateEffectFromFile( _
  filename As String, _
  flags As Long, _
  effectName As String _
) As DirectInputEffect

指定項目

object
DirectInputDevice8 オブジェクトを指定する。
filename
ファイル名を指定する文字列。
flags
エフェクトの作成方法を指定するフラグ。CONST_DIFEFFLAGS 列挙のいずれか 1 つの値を使用できる。
effectName
作成者が設定するエフェクトの登録名。

戻り値

DirectInputEffect オブジェクトを返す。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかのエラー コードが設定される。

DIERR_DEVICEFULL
DIERR_DEVICENOTREG
DIERR_INVALIDPARAM
DIERR_NOTINITIALIZED

注意

エラーが発生しない場合、エフェクトは作成され、エフェクトのパラメータはアップデートされた、しかしエフェクトは必ずしもダウンロードされてはいないことを意味する。エフェクトをダウンロードするには、デバイスを排他モードで取得しなければならない。

エフェクト ファイルは、Microsoft® DirectInput® SDK に付属する Force Editor アプリケーションで使用できる形式でなければならない。

参照

DirectInputEffect.DownloadDirectInputDevice8.WriteEffectToFile