Platform SDK: DirectX

DirectInputDevice.CreateEffect

DirectInputDevice.CreateEffect メソッドは、フォース フィードバック エフェクトを生成する。デバイスが現在排他レベルで取得されている場合、エフェクトのダウンロードも行われる。

object.CreateEffect(effectGuid As String, _
  effectinfo As DIEFFECT) As DirectInputEffect

パラメータ

object
DirectInputDevice オブジェクトを表すオブジェクト式。
effectGuid
ハードウェア ドライバにより認識されるエフェクトの GUID の文字列表現。標準のエフェクトを表す次のエイリアスのいずれかを使用できる。

GUID_ConstantForce
GUID_RampForce
GUID_Square
GUID_Sine
GUID_Triangle
GUID_SawtoothUp
GUID_SawtoothDown
GUID_Spring
GUID_Damper
GUID_Inertia
GUID_Friction

effectinfo
作成されたエフェクトに対するパラメータを格納する DIEFFECT 構造体。

戻り値

成功すれば、DirectInputEffect オブジェクトが返される。

エラー コード

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

DIERR_DEVICENOTREG
DIERR_DEVICEFULL
DIERR_INVALIDPARAM
DIERR_NOTINITIALIZED

注意

エラーが発生しない場合、エフェクトは作成済みで、エフェクトのパラメータは更新済みであるが、エフェクトをダウンロードする必要はなかった。エフェクトをダウンロードするには、デバイスを排他モードで取得しなければならない。

参照

DirectInputEffect.DownloadDirectInputEffect.Start