#include <pb_api.h>
Inherits Reference.
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. | |
 Public Member Functions inherited from Reference | |
| virtual int32_t | release () const =0 |
| Releases the instance. | |
| virtual int32_t | retain () const =0 |
| Retains the instance. | |
| virtual int32_t | retainCount () const =0 |
| Returns the current reference count. | |
Detailed Description
PrimoBurner Engine.
Member Function Documentation
◆ 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
◆ createDeviceFromHandle()
|
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
◆ error()
|
pure virtual |
Gets error information about the last operation.
- Returns
- A pointer to an ErrorInfo object.
◆ setCallback()
|
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
◆ 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.