Microsoft DirectX 9.0

IDirectMusicStyle8::EnumMotif

The EnumMotif method retrieves the name of a motif with a specified index value.

Syntax

HRESULT EnumMotif(
  DWORD dwIndex,
  WCHAR* pwszName
);

Parameters

dwIndex

Zero-based index into the style's motif list.

pwszName

Address of a buffer that receives the motif name. This should be of size MAX_PATH.

Return Values

If the method succeeds, the return value is S_OK, S_FALSE if there is no motif with the given index value, or DMUS_S_STRING_TRUNCATED if the length of the motif name is greater than MAX_PATH.

If it fails, the method can return E_POINTER.

Requirements

  Header: Declared in dmusici.h.

See Also