utils.h File Reference

Go to the source code of this file.

Functions
VOID	FileClose (IN HANDLE FileHandle)
HANDLE	FileOpen (IN PCSTR FileName, OUT PULONG FileSize OPTIONAL)
BOOLEAN	FileLoadByHandle (IN HANDLE FileHandle, IN PVOID Location, IN ULONG FileSize, OUT PULONG BytesRead)

Function Documentation

FileClose()

VOID FileClose

(

IN HANDLE

FileHandle

)

Definition at line 21 of file utils.c.

{
    CloseHandle(FileHandle);
}

Referenced by DemLoadNTDOSKernel(), DosInitialize(), FileOpen(), LoadBios(), LoadRom(), MountDisk(), OpenRomFile(), and UnmountDisk().

FileLoadByHandle()

BOOLEAN FileLoadByHandle	(	IN HANDLE	FileHandle,
		IN PVOID	Location,
		IN ULONG	FileSize,
		OUT PULONG	BytesRead
	)

Definition at line 69 of file utils.c.

{
    BOOLEAN Success;
 
    /* Attempt to load the file into memory */
    SetLastError(0); // For debugging purposes
    Success = !!ReadFile(FileHandle,
                         Location, // REAL_TO_PHYS(LocationRealPtr),
                         FileSize,
                         BytesRead,
                         NULL);
    DPRINT1("File loading %s ; GetLastError() = %u\n", Success ? "succeeded" : "failed", GetLastError());
 
    return Success;
}

Referenced by DemLoadNTDOSKernel(), DosInitialize(), and LoadRomFileByHandle().

FileOpen()

HANDLE FileOpen	(	IN PCSTR	FileName,
		OUT PULONG FileSize	OPTIONAL
	)

Definition at line 27 of file utils.c.

{
    HANDLE hFile;
    ULONG  ulFileSize;
 
    /* Open the file */
    SetLastError(0); // For debugging purposes
    hFile = CreateFileA(FileName,
                        GENERIC_READ,
                        FILE_SHARE_READ,
                        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) return NULL;
 
    /* OK, we have a handle to the file */
 
    /*
     * Retrieve the size of the file. In NTVDM we will handle files
     * of maximum 1Mb so we can largely use GetFileSize only.
     */
    ulFileSize = GetFileSize(hFile, NULL);
    if (ulFileSize == INVALID_FILE_SIZE && GetLastError() != ERROR_SUCCESS)
    {
        /* We failed, bail out */
        DPRINT1("Error when retrieving file size, or size too large (%d)\n", ulFileSize);
        FileClose(hFile);
        return NULL;
    }
 
    /* Success, return file handle and size if needed */
    if (FileSize) *FileSize = ulFileSize;
    return hFile;
}

Referenced by DemLoadNTDOSKernel(), DosInitialize(), and OpenRomFile().