Script Form

DirectMusic

Microsoft DirectX 9.0 SDK Update (Summer 2004)

Script Form

This section describes the organization of a chunk containing information about a DirectMusic script.

RIFF ( 'DMSC'
  <schd-ck>   // Script header chunk.
  [<guid-ck>]   // GUID for script.
  [<vers-ck>]   // Optional version information.
  [<UNFO-list>] // Name, author, copyright information, comments.
  <scve-ck>   // Version of DirectMusic.
  <DMCN-form>   // Container of content referenced by the script.
  <scla-ck>   // Scripting language.
  <scsr-ck> or <DMRF> // Source code.
)

<schd-ck>

The header chunk contains flags in a DMUS_IO_SCRIPT_HEADER structure.

<schd-ck> -> schd( <DMUS_IO_SCRIPT_HEADER> )

<guid-ck>, <vers-ck>, <UNFO-list>

For information on these three chunks, see Common Chunks.

<scve-ck>

This chunk describes the version of DirectMusic against which the script was authored.

<scve-ck> -> scve( <DMUS_IO_VERSION> )

<DMCN-form>

For information on this chunk, see Container Form.

<scla-ck>

This chunk consists of a null-terminated string describing the scripting language.

<scla-ck> -> scla( <WCHAR>... )

<scsr-ck> or <DMRF>

The final chunk can contain the source code as a null-terminated array of WCHAR values.

<scsr-ck> -> scsr( <WCHAR>... )

Alternatively, the final chunk can be a Reference List chunk pointing to a text file containing the script code. The guidClassID member of the DMUS_IO_REFERENCE must be GUID_NULL, because this text file is not a DirectMusic object.


© 2004 Microsoft Corporation. All rights reserved.