Copyright © 2001-2018 MultiMedia Soft

CastingSendMetaDataString method

Previous pageReturn to chapter overviewNext page

Remarks

 

Sends a string containing metadata to a SHOUTcast version 2 casting session created by a previous call to the CastingCreateFromStreamMixer or CastingCreateFromPlayer methods. If you should need sending metadata in binary format you could use the CastingSendMetaData method.

 

Details about the protocol for communicating with a SHOUTcast version 2 server and available metadata can be found inside the WinAmp Developer Network site.

 

Further information about management of casting sessions can be found inside the How to use the control as a source for streaming servers like SHOUTcast tutorial.

 

 

Syntax

 

[Visual Basic]

control.CastingSendMetaDataString (

nCastingUniqueID as Long,

nType as Long,

strMetadata as String

) as enumErrorCodes


 

[C++]

short control.CastingSendMetaDataString (

long nCastingUniqueID,

long nType,

LPCTSTR strMetadata

);


 

 

Parameter

Description

 

 

nCastingUniqueID

Unique identifier of the casting session returned by a previous call to the CastingCreateFromStreamMixer or CastingCreateFromPlayer methods

nType

Type of metadata. This is a ShoutCAST version 2 message class (in bits 12 to 15) and type (bits 0 to 11) that describes what the metadata is.

For example, the hexadecimal "3902" is a class 3 message that would contain type 902 XML Metadata in SHOUTcast version 2.0 format

strMetadata

String containing metadata, typically a string containing well formed XML

 

 

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred (see the LastError property for further error details)

enumErrorCodes.NOERROR (0)

The method call was successful