BASS_WMA_GetTags
Retrieves the tags from a WMA file.
char *BASS_WMA_GetTags(
char *file,
DWORD flags
);
Parameters
| file | The filename.
|
| flags | A combination of these flags.
| BASS_TAG_WMA_CODEC | Get codec information rather than tags.
| | BASS_UNICODE | file is a Unicode (UTF-16) filename.
|
|
Return value
If successful, the tags are returned, else NULL is returned. Use BASS_ErrorGetCode to get the error code.
Error codes
| BASS_ERROR_WMA | The Windows Media modules (v9 or above) are not installed.
|
| BASS_ERROR_FILEOPEN | The file could not be opened, or it is not a WMA file.
|
| BASS_ERROR_UNKNOWN | Some other mystery problem!
|
Remarks
This function gives the same tags as BASS_ChannelGetTags (with BASS_TAG_WMA or BASS_TAG_WMA_CODEC), which is a pointer to a series of null-terminated UTF-8 strings, the final string ending with a double null. Unlike BASS_ChannelGetTags, this function can also be used with DRM-protected WMA files without a DRM licence, as it does not require a stream to be created.
The memory used for the tags is reused by all calls of this function, so if the tags need to be retained across multiple calls, a copy should be made. It also means that this function is not thread-safe, that is it should not be called simultaneously from multiple threads.
Example
List a WMA file's tags.
char *tags=BASS_WMA_GetTags("a.wma", 0); // get the tags
if (tags)
while (*tags) {
printf("%s\n",tags); // display the tag
tags+=strlen(tags)+1; // move on to next tag
}
See also
BASS_ChannelGetTags