Effect 構造体
Effect 構造体
新しい Inputeffect オブジェクトを初期化するために、Inputdevice9Createeffect メソッドで使う。また、InputeffectSetparameters メソッドと InputeffectGetparameters メソッドでも使う。
定義
| Visual Basic | Public Structure Effect |
| C# | public struct Effect |
| Managed C++ | public __value struct Effect |
| JScript | 構造体は使えるが、独自に定義することはできない。 |
メンバ テーブル
次のテーブルは、Effect オブジェクトによって公開されているメンバの一覧である。左側のタブをクリックし、表示したいメンバの種類を選ぶこと。
フィールド
| フィールド | 説明 |
|---|---|
| ConditionStruct | |
| Constant | |
| CustomStruct | |
| EnvelopeStruct | |
| Periodic | DIEFT_PERIODIC としてマークされているエフェクトのタイプ固有の情報を保持する。この構造体は、周期的エフェクトを表す。エフェクトに関する単一の Diperiodic 構造体への参照は、Dieffect 構造体の lpvTypeSpecificParams メンバに渡される。 |
| RampStruct |
メソッド
| メソッド | 説明 |
|---|---|
| Effect | オブジェクトの新しいインスタンスを初期化する。 |
| GetAxes | |
| GetDirection | |
| SetAxes | |
| SetDirection | |
| ToString | このインスタンスの文字列表現を取得する。 |
プロパティ
| プロパティ | 説明 |
|---|---|
| Duration | エフェクトの総継続時間 (マイクロ秒単位)。この値が INFINITE であれば、エフェクトの継続時間は無限になる。TermEnvelope がエフェクトに適用されている場合は、TermAttack が適用され、続いて無限の TermSustain が適用される。 |
| EffectType | |
| Flags | エフェクトに関連付けられたフラグ。この値は、以下の値の 1 つ以上の組み合わせとなる。 |
| Gain | エフェクトに適用されるゲイン。値の範囲は 0 ～ 10,000。ゲインとは、エフェクトの全マグニチュードとそのエンベロープに適用されるスケーリング係数である。 |
| SamplePeriod | デバイスがエフェクトを再生する間隔 (マイクロ秒単位)。この値がゼロであれば、デフォルトの再生サンプリング速度を使うことを意味する。デバイスが指定の速度でエフェクトを再生できない場合は、指定された値に最も近い速度を選択する。カスタム DwSamplePeriod の設定は、特殊効果に使うことができる。たとえば、サイン波を意図的に大きなサンプリングレートで再生すると、ざらざらした質感をもたらす。 |
| StartDelay | InputeffectStart を呼び出してからエフェクトを再生するまでに、デバイスが待機する時間 (マイクロ秒単位)。この値がゼロであれば、エフェクトの再生は直ちに開始する。このメンバは、Microsoft® DirectX® 7.0 より前のバージョンには存在しない。 |
| TriggerButton | エフェクトの再生をトリガするために使うボタンの識別子またはオフセット。DIEFF_OBJECTIDS フラグと DIEFF_OBJECTOFFSETS フラグによって、この値の意味が決まる。このメンバに DIEB_NOTRIGGER が設定されている場合、エフェクトに関連付けられているトリガ ボタンはない。 |
| TriggerRepeatInterval | ボタンを押し続けることでエフェクトがトリガされたときの、1 回の再生の終了と次回の開始の間隔を表す、マイクロ秒単位の時間。繰り返しを行わない場合は、この値を INFINITE に設定する。Dieffectinfo 構造体の dwStaticParams メンバに DIEP_TRIGGERREPEATINTERVAL フラグが設定されている場合、エフェクトに対するトリガの繰り返しが可能である。 |
| UsesEnvelope | Dieffect 構造体が、エフェクトに対するオプションの TermEnvelope パラメータを指定するために使う。エンベロープの TermSustain レベルは、Diperiodic 構造体の dwMagnitude メンバと Diconstantforce 構造体の lMagnitude メンバによって示される。維持時間は、Dieffect 構造体の dwDuration メンバが示す値である。 |
構造体の情報
| 名前空間 | Microsoft.DirectX.DirectInput |
| アセンブリ | Microsoft.DirectX.DirectInput (microsoft.directx.directinput.dll) |
| 厳密名 | Microsoft.DirectX.DirectInput, Version=0293, Culture=neutral, PublicKeyToken=d3231b57b74a1492 |
© 2002 Microsoft Corporation. All rights reserved. Terms of use.