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

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.