FILES Section (Windows CE 5.0)
The FILES section specifies how Windows CE-based files are loaded into the memory table as established in the MEMORY section of the Config.bib file. This section can contain up to 2,000 files.
In these respects, this section is similar to the MODULES section. However, Romimage.exe compresses all FILES section entries by default.
Files found in this section typically include data files that are loaded into application processes, such as waveform audio (.wav) files and bitmap (.bmp) files. For more information about compression, see COMPRESSION.
The major difference between the FILES section and the MODULES section is this: If a dynamic-link library (.dll) file is placed in the FILES section, as opposed to the MODULES section, it is loaded into every slot location instead of process slot 1 only, which decreases the virtual address space available to any one process.
Process slot 1 is a 32 MB address space set aside specifically for these modules. For more information, see Memory Architecture.
The following code example shows the columnar format used in a FILES section entry.
Name Path Memory block Section override Type
Parameters
Name
This parameter specifies the name of the FILES section entry as it appears in the memory table. Usually, the Name entry is the same as the name of the file referenced by Path.Path
This parameter specifies the full path to the FILES file that Romimage.exe incorporates into the run-time image. Usually, the Path file name is the same as the Name file section entry.Memory block
This parameter specifies the MEMORY region into which Romimage.exe loads the FILES entry.Romimage.exe places the files in the specified memory area in the order in which they appear in the MEMORY section. This MEMORY region corresponds to the MEMORY section defined in the Config.bib file.
There is only one RAMIMAGE per run-time image, and the name used to specify the MEMORY section must be the same as the name specified in the Config.bib file.
Section override
This parameter specifies what type of section entry Romimage.exe treats the entry as, and can be set using the following flags:- MODULE to define it as a MODULES section entry
- FILE to define it as a FILES section entry
When this is added to an entry, Romimage.exe ignores the section that the entry resides in, and treats the entry as a member of the specified section. This is optional.
Type
This parameter specifies the file type and can be a combination of the following:- S to define it as a system file. It is part of the OS or is used exclusively by the OS.
- H to define it as a hidden file. It is not included in an ordinary directory listing.
- U to define it as an uncompressed file. All data in the file is uncompressed. This changes the default setting where all files are compressed.
- N to define a module that is not trusted.
- D to define a module that cannot be debugged by the system.
Example
FILES INITOBJ.DAT %_WINCEROOT%\RELEASE\INITOBJ.DAT NK SH
Romimage.exe creates the Initobj.dat file and loads it into the NK memory block. The file system file is a system file (S), a hidden file (H), and, by default, a compressed file.
Remarks
By default, all files are compressed because they are read into the applications. However, the type of file should dictate whether to compress a file.
TrueType font (.ttf) files are usually uncompressed because they are used constantly in the OS. Waveform audio (.wav) files are not used as frequently; therefore, they are usually compressed.
See Also
MODULES Section | Binary Image Builder File
Last updated on Thursday, February 02, 2006
Send Feedback on this topic to the authors