/*
     File:       Disks.h
 
     Contains:   Disk Driver Interfaces.
 
     Version:    Technology: System 7.5
                 Release:    QuickTime 6.0.2
 
     Copyright:  (c) 1985-2001 by Apple Computer, Inc., all rights reserved
 
     Bugs?:      For bug reports, consult the following page on
                 the World Wide Web:
 
                     http://developer.apple.com/bugreporter/
 
*/
#ifndef __DISKS__
#define __DISKS__

#ifndef __MACTYPES__
#include <MacTypes.h>
#endif

#ifndef __OSUTILS__
#include <OSUtils.h>
#endif




#if PRAGMA_ONCE
#pragma once
#endif

#ifdef __cplusplus
extern "C" {
#endif

#if PRAGMA_IMPORT
#pragma import on
#endif

#if PRAGMA_STRUCT_ALIGN
    #pragma options align=mac68k
#elif PRAGMA_STRUCT_PACKPUSH
    #pragma pack(push, 2)
#elif PRAGMA_STRUCT_PACK
    #pragma pack(2)
#endif

enum {
    sony                        = 0,
    hard20                      = 1
};

/* Disk Driver Status csCodes */
enum {
    kReturnFormatList           = 6,                            /* .Sony */
    kDriveStatus                = 8,
    kMFMStatus                  = 10
};

/* Disk Driver Control csCodes */
enum {
    kVerify                     = 5,
    kFormat                     = 6,
    kEject                      = 7,
    kSetTagBuffer               = 8,                            /* .Sony */
    kTrackCache                 = 9,                            /* .Sony */
    kDriveIcon                  = 21,
    kMediaIcon                  = 22,
    kDriveInfo                  = 23,
    kRawTrack                   = 18244                         /* .Sony: "diagnostic" raw track dump */
};

/*
    Note:

    qLink is usually the first field in queues, but back in the MacPlus
    days, the DrvSts record needed to be expanded.  In order to do this without
    breaking disk drivers that already added stuff to the end, the fields
    where added to the beginning.  This was originally done in assembly language
    and the record was defined to start at a negative offset, so that the qLink
    field would end up at offset zero.  When the C and pascal interfaces where
    made, they could not support negative record offsets, so qLink was no longer
    the first field.  Universal Interfaces are auto generated and don't support
    negative offsets for any language, so DrvSts in Disks.a has qLinks at a
    none zero offset.  Assembly code which switches to Universal Interfaces will
    need to compensate for that.

*/


struct DrvSts {
    short                           track;                      /* current track */
    char                            writeProt;                  /* bit 7 = 1 if volume is locked */
    char                            diskInPlace;                /* disk in drive */
    char                            installed;                  /* drive installed */
    char                            sides;                      /* -1 for 2-sided, 0 for 1-sided */
    QElemPtr                        qLink;                      /* next queue entry */
    short                           qType;                      /* 1 for HD20 */
    short                           dQDrive;                    /* drive number */
    short                           dQRefNum;                   /* driver reference number */
    short                           dQFSID;                     /* file system ID */
    char                            twoSideFmt;                 /* after 1st rd/wrt: 0=1 side, -1=2 side */
    char                            needsFlush;                 /* -1 for MacPlus drive */
    short                           diskErrs;                   /* soft error count */
};
typedef struct DrvSts                   DrvSts;

struct DrvSts2 {
    short                           track;
    char                            writeProt;
    char                            diskInPlace;
    char                            installed;
    char                            sides;
    QElemPtr                        qLink;
    short                           qType;
    short                           dQDrive;
    short                           dQRefNum;
    short                           dQFSID;
    short                           driveSize;
    short                           driveS1;
    short                           driveType;
    short                           driveManf;
    short                           driveChar;
    char                            driveMisc;
};
typedef struct DrvSts2                  DrvSts2;
enum {
    kdqManualEjectBit           = 5
};

#if CALL_NOT_IN_CARBON
#if CALL_NOT_IN_CARBON
EXTERN_API( OSErr )
DiskEject                       (short                  drvNum);

EXTERN_API( OSErr )
SetTagBuffer                    (void *                 buffPtr);

EXTERN_API( OSErr )
DriveStatus                     (short                  drvNum,
                                 DrvSts *               status);

#endif  /* CALL_NOT_IN_CARBON */

#endif  /* CALL_NOT_IN_CARBON */


#if PRAGMA_STRUCT_ALIGN
    #pragma options align=reset
#elif PRAGMA_STRUCT_PACKPUSH
    #pragma pack(pop)
#elif PRAGMA_STRUCT_PACK
    #pragma pack()
#endif

#ifdef PRAGMA_IMPORT_OFF
#pragma import off
#elif PRAGMA_IMPORT
#pragma import reset
#endif

#ifdef __cplusplus
}
#endif

#endif /* __DISKS__ */