IMMCDXA

The IMMCDXA class provides behavior for devices that support CD-ROM Extended Architecture (CD-XA) discs. CD-XA refers to a storage format that accommodates interleaved storage of audio, video, and standard file data.


IMMCDXA - Member Functions and Data by Group

Constructors & Destructor

You can construct and destruct objects of this class.


[view class]
~IMMCDXA
public:
virtual ~IMMCDXA()

Supported Platforms

Windows OS/2 AIX
Yes Yes No


[view class]
IMMCDXA


Overload 1
public:
IMMCDXA( bool openNow = true, unsigned long instance = 0, bool openShareable = true )

You can construct an IMMCDXA from the following:

openNow
If true, it causes the device to automatically open the device before returning from the constructor; otherwise, you would have to call one of the open functions to open the device yourself.
instance
You can provide your own instance number instead of letting IMMCDXA generate one.
openShareable
If true, it allows the hardware device to be shared by different programs; otherwise, the hardware cannot be shared.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


Overload 2
protected:
IMMCDXA( unsigned long deviceIdentifier, const IString& newAlias = IString ( ) )

A derived class can construct an IMMCDXA from the following:

deviceIdentifier
The value the system uses to identify the device.
newAlias
The name you can use to associate a string to the device. Optional.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


Implementation

These members check if the passed-in string is in the correct format to open the current device.


[view class]
isOpenStringValid
protected:
virtual bool isOpenStringValid( const IString& deviceName ) const

Returns true if the passed-in open string is valid for this device.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


UPC

Use these members to query the universal product code (upc) for the disc.


[view class]
upc
public:
IString upc(CallType call = wait) const

Returns the disc's universal product code (serial number). If the disc does not contain a upc, a null IString is returned.

Exception

IAccessError The device identifier is not valid; possibly the device is closed.
IAccessError The device cannot acquire access to the hardware device; possibly another device of this same type was acquired for exclusive use in this or another process.
IAccessError An internal driver error occurred.
IInvalidRequest The device must be in the open state before calling this function.

Supported Platforms

Windows OS/2 AIX
Yes Yes No


IMMCDXA - Inherited Member Functions and Data

Inherited Public Functions

IMMDevice
IMMPlayableDevice
IMMRemovableMedia
INotifier
IStandardNotifier

Inherited Public Data

INotifier
IMMDevice
IMMRemovableMedia

Inherited Protected Functions

IStandardNotifier
INotifier
IMMDevice
IMMPlayableDevice
IMMRemovableMedia

Inherited Protected Data