AIL_merge_DLS_with_XMI

The function AIL_merge_DLS_with_XMI merges an XMIDI file and a DLS or MLS file together.

S32 AIL_merge_DLS_with_XMI(
  void const * XMI,
  void const * dls,
  void * *mss,
  U32 *msssize
);

In Parameters

XMI

should point to a loaded XMIDI file image.

dls

should point to a loaded DLS or MLS file image.

Out Parameters

mss

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

msssize

should be the address of an unsigned 32-bit integer that will return with the size of the new merged XMIDI file image. 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 mss with AIL_mem_free_lock.

You extract the XMIDI and DLS chunks with the AIL_extract_DLS function.

You find the XMIDI and DLS chunks with the AIL_find_DLS function.

XMIDI files with merged DLS data usually have an ".MSS" extension.

Group: Utility Services
Related Functions: AIL_compress_DLS, AIL_extract_DLS, AIL_find_DLS, AIL_mem_free_lock
Related Basic Types: S32, U32, void *, void const *

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