Microsoft DirectX 8.0 (Visual Basic)

DirectInputDevice8.CreateEffect

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

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

指定項目

object
DirectInputDevice8 オブジェクトを指定する。
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_DEVICEFULL
DIERR_DEVICENOTREG
DIERR_INVALIDPARAM
DIERR_NOTINITIALIZED

注意

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

参照

DirectInputDevice8.CreateEffectFromFile

DirectInputEffect.Download

DirectInputEffect.Start