Platform SDK: DirectX

カスタム フォース

アプリケーションの作成者は、カスタム フォースを作成することによって、独自のエフェクトを作成することができる。カスタム フォースは、デバイスが再生するコンスタント フォース値の配列である。

[C++]

カスタム波形エフェクトのタイプ固有構造体は、DICUSTOMFORCE である。

DICUSTOMFORCE 構造体の dwSamplePeriod メンバと DIEFFECT 構造体の dwSamplePeriod メンバには同じ値を設定しなければならない。この値はミリ秒単位の時間であり、フォースの配列の各要素が再生される時間を表す。

DIEFFECT dwDuration メンバに設定された時間が過ぎるまで、カスタム フォースは繰り返し働く。

[Visual Basic]

カスタム フォースを生成するには、まずマグニチュードの配列を定義する。すべてのマグニチュードは -10,000 から 10,000 の範囲に含まれる。次に、この配列を DirectInputDevice.CreateCustomEffect メソッドに渡す。

samplePeriod パラメータと、DIEFFECT 型の lSamplePeriod メンバに同じ値を設定する。この値はミリ秒単位の時間であり、フォースの配列の各要素が再生される時間を表す。

DIEFFECT.lDuration に設定された時間が過ぎるまで、カスタム フォースは繰り返し働く。