277 lines
10 KiB
C
277 lines
10 KiB
C
|
/******************************************************************************
|
||
|
|
**
|
||
|
|
** Copyright 1999 Adaptec, Inc., All Rights Reserved.
|
||
|
|
**
|
||
|
|
** This software contains the valuable trade secrets of Adaptec. The
|
||
|
|
** software is protected under copyright laws as an unpublished work of
|
||
|
|
** Adaptec. Notice is for informational purposes only and does not imply
|
||
|
|
** publication. The user of this software may make copies of the software
|
||
|
|
** for use with parts manufactured by Adaptec or under license from Adaptec
|
||
|
|
** and for no other use.
|
||
|
|
**
|
||
|
|
******************************************************************************/
|
||
|
|
|
||
|
|
/******************************************************************************
|
||
|
|
**
|
||
|
|
** Module Name: ImageFile.h
|
||
|
|
**
|
||
|
|
** Description:
|
||
|
|
**
|
||
|
|
** Programmers: Daniel Evers (dle)
|
||
|
|
**
|
||
|
|
** History: 1999 98 03 (dle) Initial creation for Millenium.
|
||
|
|
**
|
||
|
|
** Notes: This file created using 4 spaces per tab.
|
||
|
|
**
|
||
|
|
******************************************************************************/
|
||
|
|
|
||
|
|
#ifndef __IMAGE_H__
|
||
|
|
#define __IMAGE_H__
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
** Make sure structures are byte aligned and fields are undecorated.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#pragma pack(1)
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif //__cplusplus
|
||
|
|
|
||
|
|
/*
|
||
|
|
* Constant declarations section.
|
||
|
|
*/
|
||
|
|
#define IMAGE_SIGNATURE 'araK'
|
||
|
|
|
||
|
|
#define IMAGE_VERSION_EDIT ((DWORD)( 0x0001 ))
|
||
|
|
#define IMAGE_VERSION_LO ((DWORD)( 0x02 ))
|
||
|
|
#define IMAGE_VERSION_HI ((DWORD)( 0x01 ))
|
||
|
|
|
||
|
|
#define IMAGE_VERSION ((( IMAGE_VERSION_HI << 24 ) & 0xff000000 ) | \
|
||
|
|
(( IMAGE_VERSION_LO << 16 ) & 0x00ff0000 ) | \
|
||
|
|
( IMAGE_VERSION_EDIT & 0x0000ffff ))
|
||
|
|
|
||
|
|
|
||
|
|
#define IMAGE_TYPE_REDBOOK_AUDIO_BLOCKSIZE 2352 // or 0x930
|
||
|
|
#define IMAGE_TYPE_DATA_MODE1_BLOCKSIZE 2048 // or 0x800
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
* Type definitions section.
|
||
|
|
*/
|
||
|
|
|
||
|
|
// Following are the definitions used to describe the content of the
|
||
|
|
// image file for various content types.
|
||
|
|
typedef enum {
|
||
|
|
eImageRecorderModeTrackAtOnce = 1,
|
||
|
|
eImageRecorderModeSessionAtOnce,
|
||
|
|
eImageRecorderModeDiscAtOnce,
|
||
|
|
eImageRecorderModeMAX
|
||
|
|
} IMAGE_RECORDER_MODE_ENUM;
|
||
|
|
|
||
|
|
typedef enum {
|
||
|
|
eImageDiscFormatDataMode1 = 1,
|
||
|
|
eImageDiscFormatAudioRedbook,
|
||
|
|
eImageDiscFormatMAX
|
||
|
|
} IMAGE_DISC_FORMAT_ENUM;
|
||
|
|
|
||
|
|
typedef enum {
|
||
|
|
eImageSectionDescConstantBlockStash = 1,
|
||
|
|
eImageSectionDescMAX
|
||
|
|
} IMAGE_SECTION_DESCRIPTOR_TYPE_ENUM;
|
||
|
|
|
||
|
|
typedef enum {
|
||
|
|
eImageSectionDataDataMode1 = 1,
|
||
|
|
eImageSectionDataAudioRedbook,
|
||
|
|
eImageSectionDataMAX
|
||
|
|
} IMAGE_SECTION_DATA_TYPE_ENUM;
|
||
|
|
|
||
|
|
typedef enum {
|
||
|
|
eImageSourceTypeStashFile = 1,
|
||
|
|
eImageSourceTypeMAX
|
||
|
|
} IMAGE_SOURCE_TYPE_ENUM;
|
||
|
|
|
||
|
|
// The structure of the image file ready to be burned as a Redboook
|
||
|
|
// audio disc is simply a series of tracks, already in the 2352-byte
|
||
|
|
// block-size format:
|
||
|
|
//
|
||
|
|
//
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | Track 1 (N1 blocks of 2352 bytes)
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | Track 2 (N2 blocks of 2352 bytes)
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | ...
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | Track T (NT blocks of 2352 bytes)
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
//
|
||
|
|
|
||
|
|
// The structure of the image file ready to be burned as a Mode 1 Data disc:
|
||
|
|
// This diagram is of a Joliet (a derivative of ISO 9660) data disc for example.
|
||
|
|
// The on-disk structure is simply the complete set of 2048 blocks that are to
|
||
|
|
// comprise the single data-track. Coincidentally, this is the strcture of
|
||
|
|
// an ISO9660 image file, so tools like CDWorkshop may be used to view the
|
||
|
|
// image in the on-disk stash file.
|
||
|
|
//
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | Block 0 (zeroes) (2048 bytes)
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | Block 1 (zeroes) (2048 bytes)
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | ...
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | Block 15 (zeroes) (2048 bytes)
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | Block 16 (ISO 9660 PVD) (2048 bytes)
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | Block 17 (SVD) (2048 bytes)
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | Block 18 (file system or data) (2048 bytes)
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | Block 19 (file system or data) (2048 bytes)
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | ...
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | Block T (file system or data) (2048 bytes)
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
//
|
||
|
|
|
||
|
|
|
||
|
|
// The in-memory structure (the Content List) used to describe the
|
||
|
|
// stash-file is as follows (structure definitions follow):
|
||
|
|
//
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | IMAGE_CONTENT_LIST
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | IMAGE_DESCRIPTOR_HEADER
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | IMAGE_SOURCE_DESCRIPTOR (including ndwSectionCount = N)
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | IMAGE_SECTION_DESCRIPTOR 1
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | IMAGE_SECTION_DESCRIPTOR 2
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | ...
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
// | IMAGE_SECTION_DESCRIPTOR N
|
||
|
|
// |------------------------------------------------------------
|
||
|
|
|
||
|
|
|
||
|
|
typedef struct {
|
||
|
|
// Block size in source.
|
||
|
|
DWORD dwBlockSize;
|
||
|
|
// Number of blocks in the track.
|
||
|
|
DWORD ndwBlockCount;
|
||
|
|
// 1-based Track Number.
|
||
|
|
DWORD idwTrackNumber;
|
||
|
|
// Must be zero.
|
||
|
|
DWORD dwaReserved[ 5 ];
|
||
|
|
|
||
|
|
// liOffsetStart and liOffsetEnd point to the starting and
|
||
|
|
// ending bytes within the image of the track. Subtracting
|
||
|
|
// liOffsetStart from liOffsetEnd must equal (dwBlockSize * ndwBlockCount).
|
||
|
|
LARGE_INTEGER liOffsetStart;
|
||
|
|
LARGE_INTEGER liOffsetEnd;
|
||
|
|
} IMAGE_SECTION_CONSTANT_BLOCK_TRACK, *PIMAGE_SECTION_CONSTANT_BLOCK_TRACK;
|
||
|
|
|
||
|
|
typedef struct {
|
||
|
|
// IMAGE_SECTION_DESCRIPTOR_TYPE_ENUM
|
||
|
|
DWORD dwSectionDescType;
|
||
|
|
// IMAGE_SECTION_DATA_TYPE_ENUM
|
||
|
|
DWORD dwSectionDataType;
|
||
|
|
DWORD dwDescriptorSize;
|
||
|
|
// Flags:
|
||
|
|
// None defined -- must be zero.
|
||
|
|
DWORD dwFlags;
|
||
|
|
// Must be IMAGE_SIGNATURE.
|
||
|
|
DWORD dwSignature;
|
||
|
|
DWORD dwaReserved[ 3 ];
|
||
|
|
|
||
|
|
union {
|
||
|
|
IMAGE_SECTION_CONSTANT_BLOCK_TRACK dataConstantBlockTrack;
|
||
|
|
} dcbt;
|
||
|
|
} IMAGE_SECTION_DESCRIPTOR, *PIMAGE_SECTION_DESCRIPTOR;
|
||
|
|
|
||
|
|
|
||
|
|
typedef struct {
|
||
|
|
HANDLE hStashFileHandle;
|
||
|
|
void *pIDiscStash;
|
||
|
|
DWORD dwaReserved[ 4 ];
|
||
|
|
} IMAGE_SOURCE_TYPE_STASH, *PIMAGE_SOURCE_TYPE_STASH;
|
||
|
|
|
||
|
|
typedef struct {
|
||
|
|
// sizeof( IMAGE_SOURCE_DESCRIPTOR )
|
||
|
|
DWORD dwHeaderSize;
|
||
|
|
// None defined -- must be zero.
|
||
|
|
DWORD dwFlags;
|
||
|
|
// IMAGE_SIGNATURE
|
||
|
|
DWORD dwSignature;
|
||
|
|
// IMAGE_SOURCE_TYPE_ENUM
|
||
|
|
DWORD dwSourceType;
|
||
|
|
// Must be zero.
|
||
|
|
DWORD dwaReserved[ 4 ];
|
||
|
|
|
||
|
|
union {
|
||
|
|
IMAGE_SOURCE_TYPE_STASH sourceStash;
|
||
|
|
} ss;
|
||
|
|
} IMAGE_SOURCE_DESCRIPTOR, *PIMAGE_SOURCE_DESCRIPTOR;
|
||
|
|
|
||
|
|
|
||
|
|
typedef struct {
|
||
|
|
// sizeof( IMAGE_DESCRIPTOR_HEADER )
|
||
|
|
DWORD dwHeaderSize;
|
||
|
|
// IMAGE_DISC_FORMAT_ENUM
|
||
|
|
DWORD dwDiscFormat;
|
||
|
|
// None defined -- must be zero.
|
||
|
|
DWORD dwFlags;
|
||
|
|
// IMAGE_RECORDER_MODE_ENUM
|
||
|
|
DWORD dwRecorderMode;
|
||
|
|
// Section count
|
||
|
|
DWORD ndwSectionCount;
|
||
|
|
// IMAGE_SIGNATURE
|
||
|
|
DWORD dwSignature;
|
||
|
|
// Must be IMAGE_VERSION.
|
||
|
|
DWORD dwVersion;
|
||
|
|
// Must be zero.
|
||
|
|
DWORD dwaReserved[ 5 ];
|
||
|
|
} IMAGE_DESCRIPTOR_HEADER, *PIMAGE_DESCRIPTOR_HEADER;
|
||
|
|
|
||
|
|
|
||
|
|
typedef struct {
|
||
|
|
// sizeof( IMAGE_CONTENT_LIST )
|
||
|
|
DWORD dwHeaderSize;
|
||
|
|
// None defined -- must be zero.
|
||
|
|
DWORD dwFlags;
|
||
|
|
// IMAGE_SIGNATURE
|
||
|
|
DWORD dwSignature;
|
||
|
|
// Must be IMAGE_VERSION.
|
||
|
|
DWORD dwVersion;
|
||
|
|
// Sum of all size of all sections.
|
||
|
|
DWORD dwContentListSize;
|
||
|
|
// Must be zero.
|
||
|
|
DWORD dwaReserved[ 3 ];
|
||
|
|
} IMAGE_CONTENT_LIST, *PIMAGE_CONTENT_LIST;
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
* Macro definitions section.
|
||
|
|
*/
|
||
|
|
#define IMAGE_GETVERSION_EDIT( Version ) LOWORD( Version )
|
||
|
|
|
||
|
|
#define IMAGE_GETVERSION_LO( Version ) LOBYTE( HIWORD( Version ))
|
||
|
|
|
||
|
|
#define IMAGE_GETVERSION_HI( Version ) HIBYTE( HIWORD( Version ))
|
||
|
|
|
||
|
|
|
||
|
|
/*
|
||
|
|
** Restore compiler default packing and close off the C declarations.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#pragma pack()
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif //__cplusplus
|
||
|
|
|
||
|
|
#endif //__IMAGE_H__
|