Audiopath Form

The following notation shows the organization of the audiopath form.

RIFF( 'DMAP' 
  [<guid-ck>]    // GUID for path.
  [<vers-ck>]    // Version information.
  [<UNFO-list>]  // Name, author, copyright, comments.
  [<DMTG-form>]  // Toolgraph.
  [<pcsl-list>]  // Port configurations.
  [<dbfl-list>]... // DirectSound buffer descriptors.
)

All elements are optional.

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

For information on these three chunks, see Common Chunks.

<DMTG-form>

See Toolgraph Form.

<pcsl-list>

Information about the configuration of ports is stored in this list.

<pcsl-list> -> LIST( 'pcsl'
  <pcfl-list>...
  )

The port configuration list consists of an array of lists in the following format:

LIST( 'pcfl' 
  <pcfh-ck>    // Header chunk.
  <pprh-ck>    // Port parameters used to create the port.
  [<dbfl-list>]... // DirectSound buffer descriptors.
  [<pchl-list>]  // Pchannel-to-buffer assignments.
  )

The port configuration list consists of several chunks, starting with headers describing the port configuration and parameters:

<pcfh-ck> -> pcfh( <DMUS_IO_PORTCONFIG_HEADER> )
 
<pprh-ck> -> pprh( <DMUS_PORTPARAMS8> )

The optional buffer descriptors are each contained in a chunk with the following format.

<dbfl-list> -> LIST( 'dbfl'
  <ddah-ck>   // Buffer attributes header 
  [<DSBC-form>] // Buffer configuration
)

This buffer description list begins with a header describing buffer attributes.

<ddah-ck> -> ( 'ddah' < DMUS_IO_BUFFER_ATTRIBUTES_HEADER > )

The header is followed by an optional DirectSound Buffer Configuration Form. This is not required for standard buffer types.

The final chunk in the port configuration list is a list containing one or more assignments of performance channels to buffers.

pchl-list -> LIST( 'pchl'
  <pchh-ck>...  
)

This list consists of an array of chunks, each of which describes one assignment of channels to buffers.

<pchh-ck> -> pchh(
  <DMUS_IO_PCHANNELTOBUFFER_HEADER>
  <GUID>... // Array of GUIDs specifying the buffers.
)

<dbfl-list>

The last part of the audiopath form consists of optional buffer descriptors identical in format to those in the port configuration list, <pcsl-list>.