AIL_list_DLS

The function AIL_list_DLS creates a detailed listing of a DLS or MLS file.

S32 AIL_list_DLS(
  void const * dls,
  char * *list,
  U32 *listsize,
  S32 flags,
  char const * filename
);

In Parameters

dls

points to a file image containing the DLS or MLS file.

flags

is zero, or one or more of the MILES_LIST_DLS_FLAGS.

filename

is the name of the DLS file. The filename is used for insertion in the list file title as well as for directory creation if the AILDLSLIST_DUMP_WAVE flag is used.

Out Parameters

list

should be the address of a " void* " pointer that will return with the pointer to the new ASCII DLS list. This parameter can be NULL if you don't need it.

listsize

should be the address of an unsigned 32-bit integer that will return with the size of the new ASCII DLS list. This parameter can be NULL if you don't need it.

Returns

1, if the call was successful, or 0 if the call failed.

Discussion

You must free the pointer returned in list with AIL_mem_free_lock.

The output ASCII list is zero-terminated.

This function is supported under Windows only.

Group: Utility Services
Related Functions: AIL_list_MIDI, AIL_mem_free_lock
Related Basic Types: MILES_LIST_DLS_FLAGS, S32, U32, char *, char const *, void const *

For technical support, e-mail Miles3@radgametools.com
© Copyright 1991-2007 RAD Game Tools, Inc. All Rights Reserved.