Platform SDK: DirectX |
DirectInputDevice.CreateCustomEffect メソッドは、固定的な継続時間を持つ一連のコンスタント フォースで構成されるフォース フィードバック エフェクトを生成する。
object.CreateCustomEffect(effectinfo As DIEFFECT, _ channels As Long, samplePeriod As Long, _ nSamples As Long, sampledata() As Long) _ As DirectInputEffect
チャネルが 1 つしか存在しない場合、エフェクトは、DIEFFECT 型の x メンバが指定する方向に回転する。カスタム エフェクトの回転をサポートしていないデバイスもある。
複数のチャネルが存在する場合、第 1 チャネルは x 軸に適用され、第 2 チャネルは y 軸に適用される。回転は許可されない。
理論的には、samplePeriod は sampledata に含まれる有効な各マグニチュードの時間の長さである。他方、DIEFFECT.lSamplePeriod は、データのサンプリング間隔 (およびマグニチュードの変化間隔の最小時間) の長さである。配列内の各要素は、配列全体を反復処理する際に一度だけサンプリングする必要があるが、ドライバによってはどのような場合にも samplePeriod を無視することがあるので、lSamplePeriod と samplePeriod の値を同じにすることが望ましい。