258 lines
11 KiB
C++
258 lines
11 KiB
C++
/*++
|
|
|
|
© 1998 Seagate Software, Inc. All rights reserved
|
|
|
|
Module Name:
|
|
|
|
RmsCartg.h
|
|
|
|
Abstract:
|
|
|
|
Declaration of the CRmsCartridge class
|
|
|
|
Author:
|
|
|
|
Brian Dodd [brian] 15-Nov-1996
|
|
|
|
Revision History:
|
|
|
|
--*/
|
|
|
|
#ifndef _RMSCARTG_
|
|
#define _RMSCARTG_
|
|
|
|
#include "resource.h" // resource symbols
|
|
|
|
#include "RmsSInfo.h" // CRmsStorageInfo
|
|
#include "RmsLocat.h" // CRmsLocator
|
|
|
|
/*++
|
|
|
|
Class Name:
|
|
|
|
CRmsCartridge
|
|
|
|
Class Description:
|
|
|
|
A CRmsCartridge represents a unit of removalble media. This can be a tape
|
|
cartridge, removable hard disk, optical platter (of various formats),
|
|
Compact Disk, or DVD Optical Disc. A Cartridge is normally designated as
|
|
either scratch or private. The Cartrige name or GUID is used by an
|
|
application when referencing a particular unit of removable media.
|
|
|
|
Cartridge information is maintained by the Removable Media Service, and
|
|
the Cartriges's properties are recreated or updated by auditing the contents of
|
|
the Library.
|
|
|
|
--*/
|
|
|
|
class CRmsCartridge :
|
|
public CComDualImpl<IRmsCartridge, &IID_IRmsCartridge, &LIBID_RMSLib>,
|
|
public CRmsStorageInfo, // inherits CRmsComObject
|
|
public CWsbObject, // inherits CComObjectRoot
|
|
public CComCoClass<CRmsCartridge,&CLSID_CRmsCartridge>
|
|
{
|
|
public:
|
|
CRmsCartridge() {}
|
|
BEGIN_COM_MAP(CRmsCartridge)
|
|
COM_INTERFACE_ENTRY2(IDispatch, IRmsCartridge)
|
|
COM_INTERFACE_ENTRY(IRmsCartridge)
|
|
COM_INTERFACE_ENTRY(IRmsComObject)
|
|
COM_INTERFACE_ENTRY(IRmsStorageInfo)
|
|
COM_INTERFACE_ENTRY(ISupportErrorInfo)
|
|
COM_INTERFACE_ENTRY2(IPersist, IPersistStream)
|
|
COM_INTERFACE_ENTRY(IPersistStream)
|
|
COM_INTERFACE_ENTRY(IWsbCollectable)
|
|
COM_INTERFACE_ENTRY(IWsbPersistStream)
|
|
COM_INTERFACE_ENTRY(IWsbTestable)
|
|
END_COM_MAP()
|
|
|
|
DECLARE_REGISTRY_RESOURCEID(IDR_RmsCartridge)
|
|
|
|
// CComObjectRoot
|
|
public:
|
|
STDMETHOD(FinalConstruct)(void);
|
|
STDMETHOD(FinalRelease)(void);
|
|
|
|
// IPersist
|
|
public:
|
|
STDMETHOD(GetClassID)(CLSID *pClsid);
|
|
|
|
// IPersistStream
|
|
public:
|
|
STDMETHOD(GetSizeMax)(ULARGE_INTEGER* pSize);
|
|
STDMETHOD(Load)(IStream* pStream);
|
|
STDMETHOD(Save)(IStream* pStream, BOOL clearDirty);
|
|
|
|
// IWsbCollectable
|
|
public:
|
|
STDMETHOD(CompareTo)( IN IUnknown *pCollectable, OUT SHORT *pResult);
|
|
WSB_FROM_CWSBOBJECT;
|
|
|
|
// IWsbTestable
|
|
public:
|
|
STDMETHOD(Test)(USHORT *pPassed, USHORT *pFailed);
|
|
|
|
// IRmsCartridge
|
|
public:
|
|
STDMETHOD(GetCartridgeId)(GUID *pCartId);
|
|
STDMETHOD(SetCartridgeId)(GUID cartId);
|
|
|
|
STDMETHOD(GetMediaSetId)(GUID *pMediaSetId);
|
|
STDMETHOD(SetMediaSetId)(GUID mediaSetId);
|
|
|
|
STDMETHOD(GetName)(BSTR *pName);
|
|
STDMETHOD(SetName)(BSTR name);
|
|
|
|
STDMETHOD(GetDescription)(BSTR *pDescription);
|
|
STDMETHOD(SetDescription)(BSTR description);
|
|
|
|
STDMETHOD(GetTagAndNumber)(BSTR *pTag, LONG *pNumber);
|
|
STDMETHOD(SetTagAndNumber)(BSTR tag, LONG number);
|
|
|
|
STDMETHOD(GetBarcode)(BSTR *pBarcode); // Same as Tag
|
|
|
|
// OnMediaIdentifier is used by DataMover
|
|
STDMETHOD(GetOnMediaIdentifier)(BYTE *pIdentifier, LONG *pSize, LONG *pType);
|
|
STDMETHOD(SetOnMediaIdentifier)(BYTE *pIdentifier, LONG size, LONG type);
|
|
|
|
// OnMediaLabel is used by DataMover
|
|
STDMETHOD(GetOnMediaLabel)(BSTR *pLabel);
|
|
STDMETHOD(SetOnMediaLabel)(BSTR label);
|
|
|
|
STDMETHOD(GetStatus)(LONG *pStatus);
|
|
STDMETHOD(SetStatus)(LONG status);
|
|
|
|
STDMETHOD(GetType)(LONG *pType);
|
|
STDMETHOD(SetType)(LONG type);
|
|
|
|
STDMETHOD(GetBlockSize)(LONG *pBlockSize);
|
|
STDMETHOD(SetBlockSize)(LONG blockSize);
|
|
|
|
STDMETHOD(IsTwoSided)(void);
|
|
STDMETHOD(SetIsTwoSided)(BOOL flag);
|
|
|
|
STDMETHOD(IsMounted)(void);
|
|
STDMETHOD(SetIsMounted)(BOOL flag);
|
|
|
|
STDMETHOD(IsAvailable)(void);
|
|
STDMETHOD(SetIsAvailable)(BOOL flag);
|
|
|
|
STDMETHOD(GetHome)(LONG *pType, GUID *pLibId, GUID *pMediaSetId, LONG *pPos, LONG *pAlt1, LONG *pAlt2, LONG *pAlt3, BOOL *pInvert);
|
|
STDMETHOD(SetHome)(LONG type, GUID libId, GUID mediaSetId, LONG pos, LONG alt1, LONG alt2, LONG alt3, BOOL invert);
|
|
|
|
STDMETHOD(GetLocation)(LONG *pType, GUID *pLibId, GUID *pMediaSetId, LONG *pPos, LONG *pAlt1, LONG *pAlt2, LONG *pAlt3, BOOL *pInvert);
|
|
STDMETHOD(SetLocation)(LONG type, GUID libId, GUID mediaSetId, LONG pos, LONG alt1, LONG alt2, LONG alt3, BOOL invert);
|
|
|
|
STDMETHOD(GetMailStop)(BSTR *pMailStop);
|
|
STDMETHOD(SetMailStop)(BSTR mailStop);
|
|
|
|
STDMETHOD(GetDrive)(IRmsDrive **ptr);
|
|
STDMETHOD(SetDrive)(IRmsDrive *ptr);
|
|
|
|
STDMETHOD(GetInfo)(UCHAR *pInfo, SHORT *pSize);
|
|
STDMETHOD(SetInfo)(UCHAR *pInfo, SHORT size);
|
|
|
|
STDMETHOD(GetOwnerClassId)(CLSID *pClassId);
|
|
STDMETHOD(SetOwnerClassId)(CLSID classId);
|
|
|
|
STDMETHOD(GetPartitions)(IWsbIndexedCollection **ptr);
|
|
|
|
STDMETHOD(GetVerifierClass)(CLSID *pClassId);
|
|
STDMETHOD(SetVerifierClass)(CLSID classId);
|
|
|
|
STDMETHOD(GetPortalClass)(CLSID *pClassId);
|
|
STDMETHOD(SetPortalClass)(CLSID classId);
|
|
|
|
STDMETHOD( Mount )( OUT IRmsDrive **ppDrive, IN DWORD dwOptions = RMS_NONE, IN DWORD threadId = 0);
|
|
STDMETHOD( Dismount )( IN DWORD dwOptions = RMS_NONE );
|
|
STDMETHOD( Home )( IN DWORD dwOptions = RMS_NONE );
|
|
|
|
STDMETHOD( CreateDataMover )( /*[out]*/ IDataMover **ptr );
|
|
STDMETHOD( ReleaseDataMover )( IN IDataMover *ptr );
|
|
|
|
STDMETHOD( LoadDataCache )(OUT BYTE *pCache, IN OUT ULONG *pSize, OUT ULONG *pUsed, OUT ULARGE_INTEGER *pStartPBA);
|
|
STDMETHOD( SaveDataCache )(IN BYTE *pCache, IN ULONG size, IN ULONG used, IN ULARGE_INTEGER startPBA);
|
|
|
|
STDMETHOD( GetManagedBy )(OUT LONG *pManagedBy);
|
|
STDMETHOD( SetManagedBy )(IN LONG managedBy);
|
|
|
|
STDMETHOD(IsFixedBlockSize)(void);
|
|
|
|
// CRmsCartridge
|
|
private:
|
|
HRESULT updateMountStats( IN BOOL bRead, IN BOOL bWrite );
|
|
|
|
private:
|
|
enum { // Class specific constants:
|
|
//
|
|
Version = 1, // Class version, this should be
|
|
// incremented each time the
|
|
// the class definition changes.
|
|
MaxInfo = RMS_STR_MAX_CARTRIDGE_INFO // Size of the application specific
|
|
// information buffer. Currently
|
|
// fixed in size.
|
|
};
|
|
CWsbBstrPtr m_externalLabel; // A string representing bar code or
|
|
// SCSI volume-tag information.
|
|
LONG m_externalNumber; // A numeric value representing
|
|
// SCSI volume-tag sequence number.
|
|
LONG m_sizeofOnMediaId; // The size of the on media identification buffer.
|
|
LONG m_typeofOnMediaId; // The type of the on media identification.
|
|
BYTE *m_pOnMediaId; // Raw on media identification buffer.
|
|
//
|
|
CWsbBstrPtr m_onMediaLabel; // The UNICODE label written on the media.
|
|
//
|
|
RmsStatus m_status; // Cartridge status (see RmsStatus).
|
|
RmsMedia m_type; // The type of Cartridge (see RmsMedia).
|
|
LONG m_BlockSize; // Media block size.
|
|
BOOL m_isTwoSided; // TRUE if the Cartridge represents two-sided media
|
|
// Note: Currently nobody sets this value -
|
|
// this should be fixed if found to be important
|
|
BOOL m_isMounted; // TRUE if the Cartridge is mounted in a drive.
|
|
BOOL m_isInTransit; // TRUE if the Cartridge is in transit between locations.
|
|
BOOL m_isAvailable; // TRUE if the Cartridge is not in use by any application
|
|
// (Note: Available here does not ensure online)
|
|
BOOL m_isMountedSerialized; // TRUE if the cartridge has been mounted as serialized
|
|
CRmsLocator m_home; // The preferred storage location
|
|
// for the Cartridge (see CRmsLocator).
|
|
CRmsLocator m_location; // The current location of the
|
|
// Cartridge (see CRmsLocator).
|
|
CRmsLocator m_destination; // The target destination location of the
|
|
// Cartridge (see CRmsLocator). Valid when
|
|
// m_isInTransit bit is set.
|
|
CWsbBstrPtr m_mailStop; // A string describing the shelf (local)
|
|
// or off-site location of a Cartridge.
|
|
// This is displayed when the Cartridge
|
|
// needs to be mounted with human
|
|
// intervention. [This field is
|
|
// created by the Import/Export dialog.]
|
|
CComPtr<IRmsDrive> m_pDrive; // The drive in which the cartridge is mounted.
|
|
SHORT m_sizeofInfo; // The size of valid data in the application
|
|
// specific information buffer.
|
|
UCHAR m_info[MaxInfo]; // Application specific information.
|
|
CLSID m_ownerClassId; // The Class ID for the application that
|
|
// owns/created the cartridge resource.
|
|
CComPtr<IWsbIndexedCollection> m_pParts; // A collection of Partitions. These
|
|
// represent the partitions on a tape
|
|
// or sides of an optical platter.
|
|
CLSID m_verifierClass; // The interface to the on-media
|
|
// ID verification function.
|
|
CLSID m_portalClass; // The interface to a site specific import
|
|
// and export storage location
|
|
// specification dialog.
|
|
|
|
BYTE * m_pDataCache; // Cache used to handle I/O for block boudary conditions
|
|
ULONG m_DataCacheSize; // Max size of the cache
|
|
ULONG m_DataCacheUsed; // The number of bytes of the cache containing valid data
|
|
ULARGE_INTEGER m_DataCacheStartPBA; // The corresponding starting PBA for the cache
|
|
|
|
RmsMode m_MountMode; // The mount mode specified for the cartridge.
|
|
|
|
RmsMediaManager m_ManagedBy; // The media manager that controls the cartridge.
|
|
|
|
static int s_InstanceCount; // Counter of the number of object instances.
|
|
};
|
|
|
|
#endif // _RMSCARTG_
|