CD Actual 9/CDACTUAL9.iso/share/Dos/VARIOS/pascal/SWAG9605.DDD/0106_Excellent Disk Drive Unit.pas

Pascal/Delphi Source File | 1996-05-31 | 18.0 KB | 646 lines

unit Drives;
{
    Drives Unit for:
        Getting and setting drive labels.
        Getting and setting drive serial number.
        Testing if a drive is ready.
        Determining the type of drive (hard/3.5/5.25...)
        Return last DOS error status.

  All procedures and functions are protected from DOS critical errors.

    Author: William R. Florac
  Company: FITCO, Verona, WI (wee little company from my house)
    Copyright 1996, FITCO.  All rights reserved.

  1) Users of Drives.pas must accept this disclaimer of warranty:
       This Unit is supplied as is.  The Fitco disclaims all
       warranties, expressed or implied, including, without limitation,
       the warranties of merchantability and of fitness for any purpose.
       Fitco assumes no liability for damages, direct or conse-
       quential, which may result from the use of this Unit."

  2) This Unit is donated to the public as public domain except as
     noted below.

  3) You must copy all Software without modification and must include
     all pages, if the Software is distributed without inclusion in your
     software product. If you are incorporating the Software in
     conjunction with and as a part of your software product which adds
     substantial value, you may modify and include portions of the
     Software.

  4) Fitco retains the copyright for this Unit.  You may not distribute
     the source code (PAS) or its compiled unit (DCU) for profit.

  5) If you do find this Unit handy and you feel guilty
     for using such a great product without paying someone,
     please feel free to send a few bucks ($25) to support further
     development.

  6) This file was formated with tabs set to 2.

    Please forward any comments or suggestions to Bill Florac at:
         email: [e-mail]
        www: http://sumac.etcconnect.com/~fitco/
        mail: FITCO
                    209 Jenna Dr
                    Verona, WI  53593

    Revision History
        2/28/96
        1.0 released
}


interface

uses
    SysUtils, WinProcs, WinTypes;

type
      TDriveStyle = (tUnknown, tNoDrive, t3Floppy, t5Floppy, tFixed, tRFixed,
        tNetwork, tCDROM, tTape);

        PDeviceParams = ^TDeviceParams;
        TDeviceParams = record
            bSpecFunc:             byte;            {Special functions}
            bDevType:             byte;            {Device type}
            wDevAttr:             word;            {Device attributes}
            wCylinders:         word;            {Number of cylinders}
            bMediaType:         byte;            {Media type}
{                          Beginning of BIOS parameter block (BPB)}
            wBytesPerSec:     word;            {Bytes per sector}
            bSecPerClust:     byte;            {Sectors per cluster}
            wResSectors:         word;            {Number of reserved sectors}
            bFATs:                     byte;            {Number of FATs}
            wRootDirEnts:     word;            {Number of root-directory entries}
            wSectors:             word;            {Total number of sectors}
            bMedia:                 byte;            {Media descriptor}
            wFATsecs:             word;            {Number of sectors per FAT}
            wSecPerTrack:     word;            {Number of sectors per track}
            wHeads:                 word;            {Number of heads}
            dwHiddenSecs:     longInt;    {Number of hidden sectors}
            dwHugeSectors:     longInt;    {Number of sectors if wSectors == 0}
            reserved:             array[0..10] of char;
{                          End of BIOS parameter block (BPB)}
        end;

    {parameter block for getting serial number}
    PSerialNumberParams = ^TSerialNumberParams;
    TSerialNumberParams = record
        wInfoLevel:                 word;
        dwDiskSerialNumber: longint;
        caLabel:                         array[0..10] of char;
        baFileSystem:             array[0..7] of char;
      end;


    {parameter block to get extened error codes}
    PExtErrorParams = ^TExtErrorParams;
  TExtErrorParams = record
    eCode:         word;
        eClass:     word;
        eAction:     word;
        eLocus:     word;
        eVolume:     String;
        end;

    {structure for FCB}
  TEFCB = record
    Flag:             byte;
    Reserved:     array [0..4] of char;
    Attribute:     byte;
    Drive:             byte;
    Name:             array [0..7] of char;
    Extension:     array [0..2] of char;
    Misc:             array  [0..24] of char;
    end;

DriveLabel = string[11];

  {my exception class}
    EDriveException = Class(Exception);

const
     {$I strings}  { can be found at the END of this module !}

{standard calls}
function DriveReady(wDrive: word): boolean;
{Tests to see if a drive is ready.  (floppy there and door closed)}

function GetDriveLabel(wDrive: word): string;
function SetDriveLabel(wDrive: word; s: string): boolean;
{Gets and sets drive label}

function GetDriveSerialNumber(wDrive: word): LongInt;
function SetDriveSerialNumber(wDrive: word; SerialNumber: LongInt): boolean;
{Gets and sets drive serial number}

function GetDefaultDrive: word;
{Returns current default drive}

function GetDriveStyle(wDrive: word): TDriveStyle;
{Returns the drive style (hard, 3-1/2, 5-1/4...)}

procedure GetExtendedErrorInfo(ep: PExtErrorParams);
{Gets the parameters for the last DOS error.  Useful after a DriveReady failure.}

{other calls}
function IsCDROMDrive(wDrive: word): boolean;
function WriteDriveSNParam(wDrive: word; psnp: PSerialNumberParams): boolean;
function ReadDriveSNParam(wDrive: word; psnp: PSerialNumberParams): boolean;
function GetDeviceParameters(wDrive: word; var dp: TDeviceParams): boolean;


implementation

{determins if the drive is ready w/o critical errors enabled}
function DriveReady(wDrive: word): boolean;
var
  OldErrorMode: Word;
begin
    {turn off errors}
  OldErrorMode := SetErrorMode(SEM_FAILCRITICALERRORS);
    try
        if DiskSize(wDrive) = -1
        then result := false
        else result := true;
  finally
        {turn on errors}
        SetErrorMode(OldErrorMode);
    end;

end;

{get drive parameters w/o drive access}
function GetDeviceParameters(wDrive: word; var dp: TDeviceParams): boolean;
begin
    result := TRUE;      {Assume success}
   asm
            push ds
      mov  bx, wDrive
      mov  ch, 08h      {Device category--must be 08h}
      mov  cl, 60h      {MS-DOS IOCTL Get Device Parameters}
      lds  dx, dp
      mov  ax, 440Dh
      int  21h
      jnc  @gdp_done     {CF SET if error}
      mov  result, FALSE
   @gdp_done:
      pop  ds
    end;
end;

{gets last error message from DOS}
procedure GetExtendedErrorInfo(ep: PExtErrorParams);
var
    tCode: word;
    tClass: byte;
    tAction: byte;
    tLocus: byte;
begin
  asm
        push ds
        push bp
      mov  bx, 0
      mov  ah, 59h
    int  21h
        mov     tCode, ax
        mov     tClass, bh
    mov     tAction, bl
        mov     tLocus, ch
        pop  bp
        pop  ds
    end;
  ep^.eCode := tCode;
    ep^.eClass := tClass;
    ep^.eAction := tAction;
    ep^.eLocus := tLocus;
    ep^.eVolume := '?'; {don't support this for now}
end;

{get volume serial number for a drive:  0=default, 1=A...}
{returns -1 if unable to read}
function GetDriveSerialNumber(wDrive: word): LongInt;
var
    snp: TSerialNumberParams;
begin
    snp.dwDiskSerialNumber := 0;
    if ReadDriveSNParam(wDrive, @snp)
    then Result := snp.dwDiskSerialNumber
    else Result := -1;
end;


{set volume serial number for a drive:  0=default, 1=A... }
{returns true if it was sucessful}
function SetDriveSerialNumber(wDrive: word; SerialNumber: LongInt): boolean;
var
    snp: TSerialNumberParams;
begin
    result := false;
    {get current parameters}
    if ReadDriveSNParam(wDrive, @snp) then begin
        {change serial number}
        snp.dwDiskSerialNumber := SerialNumber;
        {and write back out}
        if WriteDriveSNParam(wDrive, @snp) then result := true;
    end;
end;

{Write Drive parameters: 0=default, 1=A...}
{Note: wDrive and psnp are treate as var with assembler directive}
{This interupt does NOT generate a critical error!}
function WriteDriveSNParam(wDrive: word; psnp: PSerialNumberParams): boolean; assembler;
asm
    push ds           {ds might get changed so save it}
    mov  bx, wDrive
  mov  al, 01h
    mov  ah, 69h
  lds  dx, psnp
  int  21h
  jnc  @no_error    {CF SET if error}
    xor     ax,ax                {set false}
  jmp     @exit
@no_error:
  mov    ax, 1                    {set true}
@exit:
    pop    ds                        {restore ds}
end;

{Read Drive parameters: 0=default, 1=A...}
{Note: wDrive and psnp are treate as var with assembler directive}
{This interupt does NOT generate a critical error!}
function ReadDriveSNParam(wDrive: word; psnp: PSerialNumberParams): boolean; assembler;
asm
    push ds
    mov  bx, wDrive
  mov  al, 00h
    mov  ah, 69h
  lds  dx, psnp
  int  21h
  jnc  @no_error        {CF SET if error}
    xor     ax,ax        {set false}
  jmp     @exit
@no_error:
  mov    ax, 1            {set true}
@exit:
    pop    ds
end;

{sets the label of the drive specified: wDrive: 0=default 1=A...}
{returns true if it was sucessful}
function SetDriveLabel(wDrive: word; s: string): boolean;
const
        EFCB: TEFCB = (
        Flag: $FF;                              { Extended FCB Flag }
      Reserved: (#0,#0,#0,#0,#0);           { Reserved}
      Attribute: $08;                       { Volume Label Attribute}
      Drive: 2;                             { Drive Identifier}
      Name: '????????';                                          { File Name}
      Extension: '???';                     { File Extension}
      Misc: (#0, #0, #0, #0, #0,            { Misc. Info filled by DOS}
        ' ',' ',' ',' ',' ',' ',' ',' ',      { Misc. Info filled by DOS}
        ' ',' ',' ',                          { Misc. Info filled by DOS}
        #0, #0, #0, #0, #0, #0, #0, #0, #0  { Misc. Info filled by DOS}
                )
      );
var
    Ps: pchar;
    err: integer;
    x: integer;

begin
    {abort if drive not ready}
    if not DriveReady(wDrive) then begin
        result := false;
        exit;
    end;
    {assume ok}
    result := true;

    {default things that change in constant varaiable}
    EFCB.Name := '????????';
    EFCB.Extension := '???';
    EFCB.Drive := wDrive;

    {See if it exist using a FCB}
    asm
        {Check to see;  if the volume label exists}
        {point DTA to ourself}
        mov     dx,offset EFCB
        mov     ah,1Ah
        int  21h
        {point to default FCB}
       mov  dx, offset EFCB
    mov  ah, 11h
    int  21h
        {Exit if label is not present}
    cmp  al, 0
    jne  @exit
        {Else delete the volume label}
    mov  dx, offset EFCB
    mov  ah, 013h
    int  21h
    or     al,al
        jz    @exit
        mov    result, 0
  @exit:
    end;

    if not result then exit;

    {if string is empty, then just erase}
    if length(s) = 0 then exit;
    {format string}
    for x := length(s) + 1 to 11  do s[x] := ' ';
    s[0] := char(11);
    {add drive letter!}
  if wdrive = 0
    then s := '\' + s + #0
    else s := chr(64+wdrive) + ':\' + s + #0;
    ps := @s[1];

    {on now make new one it!}
    asm
        push ds
    lds  dx, ps
    mov  cx, faVolumeID
    mov  ah,3Ch
    int  21h
    {CF set if error}
    jnc  @noerror
    mov  result, FALSE
        jmp     @exit
  @noerror:
        {close file ax = handle}
        mov  bx,ax
        mov     ah,3Eh
        int     21h
  @exit:
      pop  ds
    end
end;

{Get label from drive.  0=default, 1=A...}
{return string of 11 character or "NO NAME" if not found}
function GetDriveLabel(wDrive: word): string;
const
    pattern: string[6] = 'c:\*.*';
var
    sr: TsearchRec;
  OldErrorMode: Word;
  DotPos: Byte;
begin
    {get default drive}
    if wDrive = 0
    then wDrive := GetDefaultDrive
    else dec(wDrive);

    {switch out drive letter}
    pattern[1] := char(65 + wDrive);

    {stop errors and try}
  OldErrorMode := SetErrorMode(SEM_FAILCRITICALERRORS);
    try
        if FindFirst(Pattern, faVolumeID, sr) = 0 then begin
      Result := sr.Name;
      DotPos := Pos('.', Result);
      if DotPos <> 0 then Delete(Result, DotPos, 1);
      end
        else result := 'NO NAME'
  finally
        {restore errorsa}
        SetErrorMode(OldErrorMode);
  end;
end;

function GetDefaultDrive: word; assembler;
asm
    mov    ah, 19h             {convert default to real}
    int    21h
    xor    ah, ah                {clear hi byte}
end;

{Determine id drive is a CDROM, 0=default, 1=A ...}
function IsCDROMDrive(wDrive: word): boolean; assembler;
var
    wTempDrive: word;
asm
    mov    ax, wDrive
    or  ax, ax
    jnz    @not_default
    mov    ah, 19h             {convert default to drive}
    int    21h
    xor    ah, ah
    mov wTempDrive, ax
    jmp    @test_it
@not_default:             {zero base it}
    dec    ax
    mov wTempDrive, ax
@test_it:
    mov ax, 1500h     {first test for presence of MSCDEX}
  xor bx, bx
  int 2fh
  mov ax, bx        {MSCDEX is not there if bx is zero}
    or  ax, ax        {so return FALSE}
    jz  @no_mscdex
    mov ax, 150bh     {MSCDEX driver check API}
    mov cx, wTempDrive    {...cx is drive index}
    int 2fh
    or     ax, ax
@no_mscdex:
end;

{returns drive type}
{read BOIS not drive so floppy does not have to be in drive}
{I don't have all types of drive so not all could be tested}
function GetDriveStyle(wDrive: word): TDriveStyle;
var
    x: word;
    wTempDrive: word;
    dp: TDeviceParams;
begin
    {convert default to drive}
    if wDrive = 0
    then wTempDrive := GetDefaultDrive
    else wTempDrive := wDrive - 1;
    x := GetDriveType(wTempDrive);

    {get types}
    case x of
    drive_Removable: begin
        dp.bSpecFunc := 0; {need to clear this}
        if GetDeviceParameters(wDrive,dp) then begin
            case dp.bDevType of
            0,1: result := t5floppy;        {320K/360K/1.2M}
            2,7,9: result := t3floppy;    {720K/1.44M/2.88M}
            5: result := tRFixed;         {yes a removable fixed drive!}
            6: result := tTape;         {tape}
      else result := tUnknown;
            end;
        end
        else result := tUnknown;
    end;
  drive_Fixed:
        if IsCDROMDrive(wDrive)
        then result := tCDROM
        else result := tFixed;
     drive_Remote:
        if IsCDROMDrive(wDrive) {I think this is possible on a network!}
        then result := tCDROM
        else result := tNetWork;
    else result := tUnknown;
    end;
end;

end. {of unit}

{ ----------------   STRINGS.PAS  ---------------------------------}
{ CUT }

{string constants for drives.pas}

{The error class may be one of the following}
     eClassStr: array[0..$0D] of string = (
{OK                                            }'OK',
{ERRCLASS_OUTRES (01h)    }'Out of resource, such as storage.',
{ERRCLASS_TEMPSIT (02h)    }'Not an error, temporary situation (file or record lock)',
{ERRCLASS_AUTH (03h)        }'Authorization problem.',
{ERRCLASS_INTRN (04h)        }'Internal error in system.',
{ERRCLASS_HRDFAIL (05h)    }'Hardware failure.',
{ERRCLASS_SYSFAIL (06h)    }'System software failure (missing or incorrect configuration files).',
{ERRCLASS_APPERR (07h)    }'Application error.',
{ERRCLASS_NOTFND (08h)  }'File or item not found.',
{ERRCLASS_BADFMT (09h)  }'File or item with an invalid format or type.',
{ERRCLASS_LOCKED (0Ah)  }'Interlocked file or item.',
{ERRCLASS_MEDIA (0Bh)   }'Wrong disk in drive, bad spot on disk, or other storage-medium problem.',
{ERRCLASS_ALREADY (0Ch) }'Existing file or item.',
{ERRCLASS_UNK (0Dh)           }'Unknown.');

{*The suggested action may be one of the following:}
     eActionStr: array[0..$07] of string = (
{OK                                            }'OK',
{ERRACT_RETRY (01h)            }'Retry immediately.',
{ERRACT_DLYRET (02h)        }'Delay and retry.',
{ERRACT_USER (03h)            }'Bad user input, get new values.',
{ERRACT_ABORT (04h)            }'Terminate in an orderly manner.',
{ERRACT_PANIC (05h)            }'Terminate immediately.',
{ERRACT_IGNORE (06h)        }'Ignore the error.',
{ERRACT_INTRET (07h)        }'Remove the cause of the error (to change disks, for example) and then retry.');

{The error location may be one of the following:}
eLocusStr: array[0..$05] of string = (
{OK                                            }'OK',
{ERRLOC_UNK (01h)                }'Unknown',
{ERRLOC_DISK (02h)            }'Random-access device, such as a disk drive',
{ERRLOC_NET (03h)                }'Network',
{ERRLOC_SERDEV (04h)        }'Serial device',
{ERRLOC_MEM (05h)                }'Memory');

{MS DOS error codes}
eDosErrorStr: array[0..$5A] of string = (
{0000h  non error} 'OK',
{0001h}    'ERROR_INVALID_FUNCTION',
{0002h}    'ERROR_FILE_NOT_FOUND',
{0003h}    'ERROR_PATH_NOT_FOUND',
{0004h}    'ERROR_TOO_MANY_OPEN_FILES',
{0005h}    'ERROR_ACCESS_DENIED',
{0006h}    'ERROR_INVALID_HANDLE',
{0007h}    'ERROR_ARENA_TRASHED',
{0008h}    'ERROR_NOT_ENOUGH_MEMORY',
{0009h}    'ERROR_INVALID_BLOCK',
{000Ah}    'ERROR_BAD_ENVIRONMENT',
{000Bh}    'ERROR_BAD_FORMAT',
{000Ch}    'ERROR_INVALID_ACCESS',
{000Dh}    'ERROR_INVALID_DATA',
{000Eh} 'Reserved',
{000Fh}    'ERROR_INVALID_DRIVE',
{0010h}    'ERROR_CURRENT_DIRECTORY',
{0011h}    'ERROR_NOT_SAME_DEVICE',
{0012h}    'ERROR_NO_MORE_FILES',
{0013h}    'ERROR_WRITE_PROTECT',
{0014h}    'ERROR_BAD_UNIT',
{0015h}    'ERROR_NOT_READY',
{0016h}    'ERROR_BAD_COMMAND',
{0017h}    'ERROR_CRC',
{0018h}    'ERROR_BAD_LENGTH',
{0019h}    'ERROR_SEEK',
{001Ah}    'ERROR_NOT_DOS_DISK',
{001Bh}    'ERROR_SECTOR_NOT_FOUND',
{001Ch}    'ERROR_OUT_OF_PAPER',
{001Dh}    'ERROR_WRITE_FAULT',
{001Eh}    'ERROR_READ_FAULT',
{001Fh}    'ERROR_GEN_FAILURE',
{0020h}    'ERROR_SHARING_VIOLATION',
{0021h}    'ERROR_LOCK_VIOLATION',
{0022h}    'ERROR_WRONG_DISK',
{0023h}    'ERROR_FCB_UNAVAILABLE',
{0024h}    'ERROR_SHARING_BUFFER_EXCEEDED',
{0025h}    'ERROR_CODE_PAGE_MISMATCHED',
{0026h}    'ERROR_HANDLE_EOF',
{0027h}    'ERROR_HANDLE_DISK_FULL',
{0028h} 'Reserved',
{0029h} 'Reserved',
{002Ah} 'Reserved',
{002Bh} 'Reserved',
{002Ch} 'Reserved',
{002Dh} 'Reserved',
{002Eh} 'Reserved',
{002Fh} 'Reserved',
{0030h} 'Reserved',
{0031h} 'Reserved',
{0032h}    'ERROR_NOT_SUPPORTED',
{0033h}    'ERROR_REM_NOT_LIST',
{0034h}    'ERROR_DUP_NAME',
{0035h}    'ERROR_BAD_NETPATH',
{0036h}    'ERROR_NETWORK_BUSY',
{0037h}    'ERROR_DEV_NOT_EXIST',
{0038h}    'ERROR_TOO_MANY_CMDS',
{0039h}    'ERROR_ADAP_HDW_ERR',
{003Ah}    'ERROR_BAD_NET_RESP',
{003Bh}    'ERROR_UNEXP_NET_ERR',
{003Ch}    'ERROR_BAD_REM_ADAP',
{003Dh}    'ERROR_PRINTQ _FULL',
{003Eh}    'ERROR_NO_SPOOL_SPACE',
{003Fh}    'ERROR_PRINT_CANCELLED',
{0040h}    'ERROR_NETNAME_DELETED',
{0041h}    'ERROR_NETWORK_ACCESS_DENIED',
{0042h}    'ERROR_BAD_DEV_TYPE',
{0043h}    'ERROR_BAD_NET_NAME',
{0044h}    'ERROR_TOO_MANY_NAMES',
{0045h}    'ERROR_TOO_MANY_SESS',
{0046h}    'ERROR_SHARING_PAUSED',
{0047h}    'ERROR_ERROR_REQ _NOT_ACCEP',
{0048h}    'ERROR_REDIR_PAUSED',
{0049h} 'Reserved',
{004Ah} 'Reserved',
{004Bh} 'Reserved',
{004Ch} 'Reserved',
{004Dh} 'Reserved',
{004Eh} 'Reserved',
{004Fh} 'Reserved',
{0050h}    'ERROR_FILE_EXISTS',
{0051h}    'ERROR_DUP_FCB',
{0052h}    'ERROR_CANNOT_MAKE',
{0053h}    'ERROR_FAIL_I24',
{0054h}    'ERROR_OUT_OF_STRUCTURES',
{0055h}    'ERROR_ALREADY_ASSIGNED',
{0056h}    'ERROR_INVALID_PASSWORD',
{0057h}    'ERROR_INVALID_PARAMETER',
{0058h}    'ERROR_NET_WRITE_FAULT',
{0059h}    'Function not supported on Network',
{005Ah}    'ERROR_SYS_COMP_NOT_LOADED');

cDriveStr: array[0..8] of string = (
            'Unknown',
            'NoDrive',
            '3-1/2" floppy',
            '5-1/4" floppy',
             'hard',
            'removable hard',
            'network',
            'CD ROM',
      'tape');