DIENVELOPE

The DIENVELOPE structure is used by the DIEFFECT structure to specify the optional envelope parameters for an effect. The sustain level for the envelope is represented by the dwMagnitude member of the DIPERIODIC structure and the lMagnitude member of the DICONSTANTFORCE structure. The sustain time is represented by dwDuration member of the DIEFFECT structure.

typedef struct { 
    DWORD dwSize; 
    DWORD dwAttackLevel; 
    DWORD dwAttackTime; 
    DWORD dwFadeLevel; 
    DWORD dwFadeTime; 
} DIENVELOPE, *LPDIENVELOPE; 
 
typedef const DIENVELOPE *LPCDIENVELOPE;
 

Members

dwSize

The size, in bytes, of the structure. This member must be initialized before the structure is used.

dwAttackLevel

Amplitude for the start of the envelope, relative to the baseline, in the range 0 to 10,000. If the effect's type-specific data does not specify a baseline, then the amplitude is relative to zero.

dwAttackTime

The time, in microseconds, to reach the sustain level.

dwFadeLevel

Amplitude for the end of the envelope, relative to the baseline, in the range 0 to 10,000. If the effect's type-specific data does not specify a baseline, then the amplitude is relative to zero.

dwFadeTime

The time, in microseconds, to reach the fade level.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in dinput.h.