Previous

Next

Function RTMakeBootDisk

RTMakeBootDisk can create a bootable diskette or hard disk just like program BootDisk:

int RTMakeBootDisk(char         LogicalDrive, 
                   int          BIOSDevice, 
                   const char * RTBFileName, 
                   char *       Buffer, 
                   int          BufferSize, 
                   DWORD        Flags);

RTMakeBootDisk requires On Time's embedded file system RTFiles-32 and is not included in RTTarget-32's preconfigured system DLL Rtt32dll.dll.

Parameters

LogicalDrive

Specifies the logical disk drive from which to boot. The new boot image file (.RTA file) will be created in the root directory of that drive.

BIOSDevice

Specifies the physical device identification used by the BIOS for the device at boot time. If this parameter is set to -1, the disk loader will choose an appropriate default based on information passed by the BIOS.

RTBFileName

Points to the file name of the .RTB file to install on the bootable drive.

Buffer

Must point to a temporary buffer to be used as a disk buffer by RTMakeBootDisk. It should have a size of at least Header Size + (Number of Sections * 4) + 1024. Values Header Size and Number of Sections are given in the [Application Image File Report] in the .LOC file of the .RTB file to install as a boot image. Larger sizes may improve performance for large .RTB files. For most .RTB files, 16k will be sufficient and 64k will yield good performance.

BufferSize

Specifies the size in bytes of the buffer referenced by parameter Buffer.

Flags

Zero or a combination of the following flags:

return value

Can be one of the following:

When flag RT_BDISK_DEL_RTA is not specified, RTMakeBootDisk guarantees that the new program is properly installed or, in case of an error, any previously existing boot image is still bootable. With flag RT_BDISK_DEL_RTA set, the disk may be left in an unbootable state if the function fails. In particular, the following steps are performed:

• If no backup boot sector is present, the current boot sector is saved as file BOOTSECT.RTT on the target drive.
• If flag RT_BDISK_DEL_RTA is set, all .RTA files in the target drive's root directory are deleted.
• A contiguous temporary file to receive the boot image is created in the root directory of the target drive and is written.
• The new boot sector is written to the disk. If this step succeeds, the new boot image is now bootable.
• If not done already, all .RTA files in the target drive's root directory are deleted.
• The temporary file with the boot image is renamed to the .RTB file's base name with extension .RTA.

Unlike program Bootdisk, function RTMakeBootDisk does not set the partition hosting the target LogicalDrive active.

Function RTDLLThreadEvent

Function RTRestoreBootSector