/// <summary>
/// Replaces the comment packet in a collection of packets
/// with the rendered version of a Xiph comment or inserts a
/// comment packet if the stream lacks one.
/// </summary>
/// <param name="packets">
/// A <see cref="ByteVectorCollection" /> object containing
/// a collection of packets.
/// </param>
/// <param name="comment">
/// A <see cref="XiphComment" /> object to store the rendered
/// version of in <paramref name="packets" />.
/// </param>
/// <exception cref="ArgumentNullException">
/// <paramref name="packets" /> or <paramref name="comment"
/// /> is <see langword="null" />.
/// </exception>
public abstract void SetCommentPacket(ByteVectorCollection packets,
XiphComment comment);
/// <summary>
/// Stores a Xiph comment in the codec-specific comment
/// packet.
/// </summary>
/// <param name="comment">
/// A <see cref="XiphComment" /> object to store in the
/// comment packet.
/// </param>
public void SetComment(XiphComment comment)
{
codec.SetCommentPacket(packets, comment);
}
/// <summary>
/// Adds a Xiph comment to the current instance.
/// </summary>
/// <param name="streamSerialNumber">
/// A <see cref="uint" /> value containing the serial number
/// of the stream containing the comment.
/// </param>
/// <param name="comment">
/// A <see cref="XiphComment" /> object to add to the current
/// instance.
/// </param>
public void AddComment(uint streamSerialNumber,
XiphComment comment)
{
comment_hash.Add(streamSerialNumber, comment);
tags.Add(comment);
}