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 DIENVELOPE { 
    DWORD dwSize; 
    DWORD dwAttackLevel; 
    DWORD dwAttackTime; 
    DWORD dwFadeLevel; 
    DWORD dwFadeTime; 
} DIENVELOPE, *LPDIENVELOPE; 
 
typedef const DIENVELOPE *LPCDIENVELOPE;

Members

dwSize

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 from 0 through 10,000. If the effect's type-specific data does not specify a baseline, the amplitude is relative to 0.

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 from 0 through 10,000. If the effect's type-specific data does not specify a baseline, the amplitude is relative to 0.

dwFadeTime

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

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dinput.h.