DiscArchiveFooterPolicy Class Reference

Implement this interface to provide information to DiscArchive for managing the footer size. More...

#include <PrimoBurner.h>

Inherits Reference.

List of all members.

Public Member Functions
virtual bool_t	add (DataFile *file, int64_t maxIncrement)
	This method is called during DiscArchive::prepareLayout().
int32_t	release () const
	Simple implementation of primo::Reference::release.
int32_t	retain () const
	Simple implementation of primo::Reference::retain.
int32_t	retainCount () const
	Simple implementation of primo::Reference::retainCount.
virtual int64_t	size ()
	This method is called when DiscArchive needs to know footer size during DiscArchive::prepareLayout().

---

Detailed Description

Implement this interface to provide information to DiscArchive for managing the footer size.

See also:

DiscArchive::setFooterPolicy

DiscArchive::footerPolicy

---

Member Function Documentation

virtual bool_t add	(	DataFile *	file,
		int64_t	maxIncrement
	)		[virtual]

This method is called during DiscArchive::prepareLayout().

Parameters:

file	[in] The file that is to be added to the layout.
maxIncrement	[in] The maximum space available for the footer to grow.

Remarks:

It is possible that each file added to the layout will result in increase of the footer size. Use this method to reflect such changes. This method is called by DiscArchive to inform the client code which file is to be added to the layout and how much free space on the target disc could be used for the footer size to grow (maxIncrement).

Returns:

TRUE if the specified file should be added to the layout by DiscArchive, FALSE otherwise.

Return FALSE to exclude a file from the layout currently being constructed (DiscArchive::prepareLayout()). Doing so will also stop the process from traversing other directories apart from those that are in the path of the specified file.

int32_t release

(

)

const [virtual]

Simple implementation of primo::Reference::release.

Returns:

The updated reference count.

Implements Reference.

int32_t retain

(

)

const [virtual]

Simple implementation of primo::Reference::retain.

Returns:

The updated reference count.

Implements Reference.

int32_t retainCount

(

)

const [virtual]

Simple implementation of primo::Reference::retainCount.

Returns:

The current reference count.

Implements Reference.

virtual int64_t size

(

)

[virtual]

This method is called when DiscArchive needs to know footer size during DiscArchive::prepareLayout().

Remarks:

Override this method if the footer size changes after each file is added to the layout (DiscLayout). This callback method may be called frequently by DiscArchive. An inefficient implementation may slow down the creation of the layout.

Returns:

The current footer size in bytes. Return -1 if the footer size is unknown (cannot be calculated).