DIENVELOPE Structure

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.

Syntax

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.

Structure Information

Header	dinput.h
Minimum operating systems	Windows 98