IDirectMusicLoader::EnumObject

The IDirectMusicLoader::EnumObject method enumerates all available objects of the requested type. Objects are available if they have been loaded or if IDirectMusicLoader::ScanDirectory has been called on the search directory.

HRESULT EnumObject(
  REFGUID rguidClass, 
  DWORD dwIndex, 
  LPDMUS_OBJECTDESC pDesc
);

Parameters

rguidClass

Reference to (C++) or address of (C) the identifier for the class of objects to view.

dwIndex

Index into the list. Typically, starts with 0 and increments.

pDesc

Address of a DMUS_OBJECTDESC structure to be filled with data about the object.

Return Values

If the method succeeds, the return value is S_OK, or S_FALSE if dwIndex is past the end of the list.

Remarks

For an example of the use of this method, see Enumerating Objects.

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 dmusici.h.

See Also

IDirectMusicLoader::ScanDirectory