IDirectMusicStyle::GetEmbellishmentLength

The IDirectMusicStyle::GetEmbellishmentLength method 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

A groove level in the range 1 to 100. Ignored for non-groove embellishments.

pdwMin

Length of the shortest pattern of the specified type and groove level.

pdwMax

Length 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 the method fails, the return value may be E_POINTER.

Remarks

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

QuickInfo

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