disk.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	_DISK_INFO
struct	_DISK_IMAGE

Typedefs
typedef struct _DISK_INFO	DISK_INFO
typedef struct _DISK_INFO *	PDISK_INFO
typedef struct _DISK_IMAGE	DISK_IMAGE
typedef struct _DISK_IMAGE *	PDISK_IMAGE
typedef enum _DISK_TYPE	DISK_TYPE

Enumerations
enum	_DISK_TYPE { FLOPPY_DISK , HARD_DISK , MAX_DISK_TYPE }

Functions
BOOLEAN	IsDiskPresent (IN PDISK_IMAGE DiskImage)
BYTE	SeekDisk (IN PDISK_IMAGE DiskImage, IN WORD Cylinder, IN BYTE Head, IN BYTE Sector)
BYTE	ReadDisk (IN PDISK_IMAGE DiskImage, IN WORD Cylinder, IN BYTE Head, IN BYTE Sector, IN BYTE NumSectors)
BYTE	WriteDisk (IN PDISK_IMAGE DiskImage, IN WORD Cylinder, IN BYTE Head, IN BYTE Sector, IN BYTE NumSectors)
PDISK_IMAGE	RetrieveDisk (IN DISK_TYPE DiskType, IN ULONG DiskNumber)
BOOLEAN	MountDisk (IN DISK_TYPE DiskType, IN ULONG DiskNumber, IN PCWSTR FileName, IN BOOLEAN ReadOnly)
BOOLEAN	UnmountDisk (IN DISK_TYPE DiskType, IN ULONG DiskNumber)
BOOLEAN	DiskCtrlInitialize (VOID)
VOID	DiskCtrlCleanup (VOID)

Typedef Documentation

DISK_IMAGE

typedef struct _DISK_IMAGE DISK_IMAGE

DISK_INFO

typedef struct _DISK_INFO DISK_INFO

DISK_TYPE

typedef enum _DISK_TYPE DISK_TYPE

PDISK_IMAGE

typedef struct _DISK_IMAGE * PDISK_IMAGE

PDISK_INFO

typedef struct _DISK_INFO * PDISK_INFO

Enumeration Type Documentation

_DISK_TYPE

enum _DISK_TYPE

Enumerator
FLOPPY_DISK
HARD_DISK
MAX_DISK_TYPE

Definition at line 42 of file disk.h.

{
    FLOPPY_DISK,
    HARD_DISK,
    MAX_DISK_TYPE
} DISK_TYPE;

Function Documentation

DiskCtrlCleanup()

VOID DiskCtrlCleanup

(

VOID

)

Definition at line 624 of file disk.c.

{
    ULONG DiskNumber;
 
    /* Unmount all the present floppy disk drives */
    for (DiskNumber = 0; DiskNumber < DiskMountInfo[FLOPPY_DISK].NumDisks; ++DiskNumber)
    {
        if (IsDiskPresent(&DiskMountInfo[FLOPPY_DISK].DiskArray[DiskNumber]))
            UnmountDisk(FLOPPY_DISK, DiskNumber);
    }
 
    /* Unmount all the present hard disk drives */
    for (DiskNumber = 0; DiskNumber < DiskMountInfo[HARD_DISK].NumDisks; ++DiskNumber)
    {
        if (IsDiskPresent(&DiskMountInfo[HARD_DISK].DiskArray[DiskNumber]))
            UnmountDisk(HARD_DISK, DiskNumber);
    }
}

Referenced by EmulatorCleanup().

DiskCtrlInitialize()

BOOLEAN DiskCtrlInitialize

(

VOID

)

Definition at line 619 of file disk.c.

{
    return TRUE;
}

Referenced by EmulatorInitialize().

IsDiskPresent()

BOOLEAN IsDiskPresent

(

IN PDISK_IMAGE

DiskImage

)

Definition at line 321 of file disk.c.

{
    ASSERT(DiskImage);
    return (DiskImage->hDisk != INVALID_HANDLE_VALUE && DiskImage->hDisk != NULL);
}

Referenced by BiosDiskService(), DiskCtrlCleanup(), MountDisk(), and UnmountDisk().

MountDisk()

BOOLEAN MountDisk	(	IN DISK_TYPE	DiskType,
		IN ULONG	DiskNumber,
		IN PCWSTR	FileName,
		IN BOOLEAN	ReadOnly
	)

Definition at line 500 of file disk.c.

{
    BOOLEAN Success = FALSE;
    PDISK_IMAGE DiskImage;
    HANDLE hFile;
 
    BY_HANDLE_FILE_INFORMATION FileInformation;
 
    ASSERT(DiskType < MAX_DISK_TYPE);
 
    if (DiskNumber >= DiskMountInfo[DiskType].NumDisks)
    {
        DisplayMessage(L"MountDisk: Disk number %d:%d invalid.", DiskType, DiskNumber);
        return FALSE;
    }
 
    DiskImage = &DiskMountInfo[DiskType].DiskArray[DiskNumber];
    if (IsDiskPresent(DiskImage))
    {
        DPRINT1("MountDisk: Disk %d:%d:0x%p already in use, recycling...\n", DiskType, DiskNumber, DiskImage);
        UnmountDisk(DiskType, DiskNumber);
    }
 
    /* Try to open the file */
    SetLastError(0); // For debugging purposes
    hFile = CreateFileW(FileName,
                        GENERIC_READ | (ReadOnly ? 0 : GENERIC_WRITE),
                        (ReadOnly ? FILE_SHARE_READ : 0),
                        NULL,
                        OPEN_EXISTING,
                        FILE_ATTRIBUTE_NORMAL,
                        NULL);
    DPRINT1("File '%S' opening %s ; GetLastError() = %u\n",
            FileName, hFile != INVALID_HANDLE_VALUE ? "succeeded" : "failed", GetLastError());
 
    /* If we failed, bail out */
    if (hFile == INVALID_HANDLE_VALUE)
    {
        DisplayMessage(L"MountDisk: Error when opening disk file '%s' (Error: %u).", FileName, GetLastError());
        return FALSE;
    }
 
    /* OK, we have a handle to the file */
 
    /*
     * Check that it is really a file, and not a physical drive.
     * For obvious security reasons, we do not want to be able to
     * write directly to physical drives.
     *
     * Redundant checks
     */
    SetLastError(0);
    if (!GetFileInformationByHandle(hFile, &FileInformation) &&
        GetLastError() == ERROR_INVALID_FUNCTION)
    {
        /* Objects other than real files are not supported */
        DisplayMessage(L"MountDisk: '%s' is not a valid disk file.", FileName);
        goto Quit;
    }
    SetLastError(0);
    if (GetFileSize(hFile, NULL) == INVALID_FILE_SIZE &&
        GetLastError() == ERROR_INVALID_FUNCTION)
    {
        /* Objects other than real files are not supported */
        DisplayMessage(L"MountDisk: '%s' is not a valid disk file.", FileName);
        goto Quit;
    }
 
    /* Success, mount the image */
    if (!DiskMountInfo[DiskType].MountDiskHelper(DiskImage, hFile))
    {
        DisplayMessage(L"MountDisk: Failed to mount disk file '%s' in 0x%p.", FileName, DiskImage);
        goto Quit;
    }
 
    /* Update its read/write state */
    DiskImage->ReadOnly = ReadOnly;
 
    Success = TRUE;
 
Quit:
    if (!Success) FileClose(hFile);
    return Success;
}

Referenced by EmulatorInitialize(), and MountFloppy().

ReadDisk()

BYTE ReadDisk	(	IN PDISK_IMAGE	DiskImage,
		IN WORD	Cylinder,
		IN BYTE	Head,
		IN BYTE	Sector,
		IN BYTE	NumSectors
	)

Definition at line 359 of file disk.c.

{
    BYTE Result;
    DWORD BytesToRead;
 
    PVOID LocalBuffer;
    BYTE StaticBuffer[1024];
 
    /* Read the sectors */
    Result = SeekDisk(DiskImage, Cylinder, Head, Sector);
    if (Result != 0x00)
        return Result;
 
    BytesToRead = (DWORD)NumSectors * DiskImage->DiskInfo.SectorSize;
 
    // FIXME: Consider just looping around filling each time the buffer...
 
    if (BytesToRead <= sizeof(StaticBuffer))
    {
        LocalBuffer = StaticBuffer;
    }
    else
    {
        LocalBuffer = RtlAllocateHeap(RtlGetProcessHeap(), 0, BytesToRead);
        ASSERT(LocalBuffer != NULL);
    }
 
    if (ReadFile(DiskImage->hDisk, LocalBuffer, BytesToRead, &BytesToRead, NULL))
    {
        /* Write to the memory */
        EmulatorWriteMemory(&EmulatorContext,
                            TO_LINEAR(getES(), getBX()),
                            LocalBuffer,
                            BytesToRead);
 
        Result = 0x00;
    }
    else
    {
        Result = 0x04;
    }
 
    if (LocalBuffer != StaticBuffer)
        RtlFreeHeap(RtlGetProcessHeap(), 0, LocalBuffer);
 
    /* Return success or error */
    return Result;
}

Referenced by BiosDiskService().

RetrieveDisk()

PDISK_IMAGE RetrieveDisk	(	IN DISK_TYPE	DiskType,
		IN ULONG	DiskNumber
	)

Definition at line 485 of file disk.c.

{
    ASSERT(DiskType < MAX_DISK_TYPE);
 
    if (DiskNumber >= DiskMountInfo[DiskType].NumDisks)
    {
        DisplayMessage(L"RetrieveDisk: Disk number %d:%d invalid.", DiskType, DiskNumber);
        return NULL;
    }
 
    return &DiskMountInfo[DiskType].DiskArray[DiskNumber];
}

Referenced by DiskBios32Initialize().

SeekDisk()

BYTE SeekDisk	(	IN PDISK_IMAGE	DiskImage,
		IN WORD	Cylinder,
		IN BYTE	Head,
		IN BYTE	Sector
	)

Definition at line 328 of file disk.c.

{
    DWORD FilePointer;
 
    /* Check that the sector number is 1-based */
    // FIXME: Or do it in the caller?
    if (Sector == 0)
    {
        /* Return error */
        return 0x01;
    }
 
    /* Set position */
    // Compute the offset
    FilePointer = (DWORD)((DWORD)((DWORD)Cylinder * DiskImage->DiskInfo.Heads + Head)
                    * DiskImage->DiskInfo.Sectors + (Sector - 1))
                    * DiskImage->DiskInfo.SectorSize;
    FilePointer = SetFilePointer(DiskImage->hDisk, FilePointer, NULL, FILE_BEGIN);
    if (FilePointer == INVALID_SET_FILE_POINTER)
    {
        /* Return error */
        return 0x40;
    }
 
    return 0x00;
}

Referenced by BiosDiskService(), ReadDisk(), and WriteDisk().

UnmountDisk()

BOOLEAN UnmountDisk	(	IN DISK_TYPE	DiskType,
		IN ULONG	DiskNumber
	)

Definition at line 589 of file disk.c.

{
    PDISK_IMAGE DiskImage;
 
    ASSERT(DiskType < MAX_DISK_TYPE);
 
    if (DiskNumber >= DiskMountInfo[DiskType].NumDisks)
    {
        DisplayMessage(L"UnmountDisk: Disk number %d:%d invalid.", DiskType, DiskNumber);
        return FALSE;
    }
 
    DiskImage = &DiskMountInfo[DiskType].DiskArray[DiskNumber];
    if (!IsDiskPresent(DiskImage))
    {
        DPRINT1("UnmountDisk: Disk %d:%d:0x%p is already unmounted\n", DiskType, DiskNumber, DiskImage);
        return FALSE;
    }
 
    /* Flush the image and unmount it */
    FlushFileBuffers(DiskImage->hDisk);
    FileClose(DiskImage->hDisk);
    DiskImage->hDisk = NULL;
    return TRUE;
}

Referenced by DiskCtrlCleanup(), EjectFloppy(), and MountDisk().

WriteDisk()

BYTE WriteDisk	(	IN PDISK_IMAGE	DiskImage,
		IN WORD	Cylinder,
		IN BYTE	Head,
		IN BYTE	Sector,
		IN BYTE	NumSectors
	)

Definition at line 413 of file disk.c.

{
    BYTE Result;
    DWORD BytesToWrite;
 
    PVOID LocalBuffer;
    BYTE StaticBuffer[1024];
 
    /* Check for write protection */
    if (DiskImage->ReadOnly)
    {
        /* Return error */
        return 0x03;
    }
 
    /* Write the sectors */
    Result = SeekDisk(DiskImage, Cylinder, Head, Sector);
    if (Result != 0x00)
        return Result;
 
    BytesToWrite = (DWORD)NumSectors * DiskImage->DiskInfo.SectorSize;
 
    // FIXME: Consider just looping around filling each time the buffer...
 
    if (BytesToWrite <= sizeof(StaticBuffer))
    {
        LocalBuffer = StaticBuffer;
    }
    else
    {
        LocalBuffer = RtlAllocateHeap(RtlGetProcessHeap(), 0, BytesToWrite);
        ASSERT(LocalBuffer != NULL);
    }
 
    /* Read from the memory */
    EmulatorReadMemory(&EmulatorContext,
                       TO_LINEAR(getES(), getBX()),
                       LocalBuffer,
                       BytesToWrite);
 
    if (WriteFile(DiskImage->hDisk, LocalBuffer, BytesToWrite, &BytesToWrite, NULL))
        Result = 0x00;
    else
        Result = 0x04;
 
    if (LocalBuffer != StaticBuffer)
        RtlFreeHeap(RtlGetProcessHeap(), 0, LocalBuffer);
 
    /* Return success or error */
    return Result;
}

Referenced by BiosDiskService().