Microsoft DirectX 8.0 (C++)

IDirectMusicStyle8::GetEmbellishmentLength

Finds the shortest and longest lengths for patterns of the specified embellishment type and groove level.

HRESULT GetEmbellishmentLength(
  DWORD dwType, 
  DWORD dwLevel, 
  DWORD* pdwMin, 
  DWORD* pdwMax
);

Parameters

dwType
Embellishment type. See DMUS_COMMANDT_TYPES.
dwLevel
Groove level, in the range from 1 through 100. Ignored if dwType is not DMUS_COMMANDT_GROOVE.
pdwMin
Address of a variable that receives the length, in measures, of the shortest pattern of the specified type and groove level.
pdwMax
Address of a variable that receives the length, in measures, of the longest pattern of the specified type and groove level.

Return Values

If the method succeeds, the return value is S_OK or S_FALSE.

If it fails, the method can return E_POINTER.

Remarks

If there are no patterns of the specified type and groove level, the method returns S_FALSE.

Requirements

  Header: Declared in dmusici.h.