Engine Class Reference

PrimoBurner Engine. More...

#include <PrimoBurner.h>

Inherits Reference.

List of all members.

Public Member Functions
virtual DeviceEnum *	createDeviceEnumerator ()=0
	Enumerates the optical devices installed in the system.
virtual Device *	createDeviceFromHandle (handle_t handle)=0
	Creates a Device object from device handle.
virtual const ErrorInfo *	error () const =0
	Gets error information about the last operation.
virtual bool_t	initialize ()=0
	Initializes the engine object.
virtual void	setCallback (EngineCallback *callback)=0
	Sets a notification callback object to receive device change notifications (arrival/removal of devices and media)
virtual void	shutdown ()=0
	The Shutdown method shuts down the object.

---

Detailed Description

PrimoBurner Engine.

---

Member Function Documentation

virtual DeviceEnum* createDeviceEnumerator

(

)

[pure virtual]

Enumerates the optical devices installed in the system.

Returns:

DeviceEnum object that can be used for creating device instances.

NULL if engine has not been initialized and also sets error to EngineError::NotInitialized.

Remarks:

On Windows this method enumerates only devices, which have drive letters assigned.

See also:

DeviceEnum

virtual Device* createDeviceFromHandle

(

handle_t

handle

)

[pure virtual]

Creates a Device object from device handle.

Parameters:

handle

OS handle obtained from Device::deviceHandle.

Returns:

A new Device object.

NULL if engine has not been initialized and also sets error to EngineError::NotInitialized.

Remarks:

Together with Device::deviceHandle this method allows to pass a Device between different processes and library versions.

On Linux the method always returns NULL.

See also:

Object Management

virtual const ErrorInfo* error

(

)

const [pure virtual]

Gets error information about the last operation.

Returns:

A pointer to an ErrorInfo object.

virtual void setCallback

(

EngineCallback *

callback

)

[pure virtual]

Sets a notification callback object to receive device change notifications (arrival/removal of devices and media)

Parameters:

callback

A pointer to an object that implements the EngineCallback interface.

Internally the EngineCallback is retained (if not NULL). The previous EngineCallback is released (if not NULL). The EngineCallback instance is released when the Engine itself is being destroyed.

NOTE: If the user code inherits from EngineCallback but does not override primo::Reference::release() and primo::Reference::retain() it must ensure that the callback instance is valid until it is used by the engine. This is so because the default implementation of primo::Reference in EngineCallback keeps a constant reference count of 1.

See also:

EngineCallback

virtual void shutdown

(

)

[pure virtual]

The Shutdown method shuts down the object.

Shutdown unlocks any devices that have been locked and frees the internal structures associated with every device.