Name
GetFormatName -- get human-readable stream format name (V5.0)
Synopsis
STRPTR name = GetFormatName(APTR handle);
Function
This function must return a human-readable name for the stream format of the sound file handle passed as parameter 1. This string can be retrieved from Hollywood by querying the #ATTRFORMAT constant on #MUSIC objects.

Warning! Before version 9.0 Hollywood didn't copy the string returned into a local buffer which means that the string must remain valid even after CloseStream() has been called. Thus, it is highly suggested that you use a static buffer for the string that this function returns (unless you explicitly target Hollywood 9.0 or higher).

Inputs
handle
handle returned by OpenStream()
Results
name
stream format name

Show TOC