mirror of
https://github.com/SabreTools/SabreTools.Serialization.git
synced 2026-04-17 03:33:06 +00:00
7689c6dd07
This change looks dramatic, but it's just separating out the already-split namespaces into separate top-level folders. In theory, every single one could be built into their own Nuget package. `SabreTools.Serialization` still builds the normal Nuget package that is used by all other projects and includes all namespaces.
77 lines
3.2 KiB
C#
77 lines
3.2 KiB
C#
namespace SabreTools.Data.Models.PortableExecutable.Resource
|
|
{
|
|
/// <summary>
|
|
/// A leaf's Type, Name, and Language IDs are determined by the path that is
|
|
/// taken through directory tables to reach the leaf. The first table
|
|
/// determines Type ID, the second table (pointed to by the directory entry
|
|
/// in the first table) determines Name ID, and the third table determines
|
|
/// Language ID.
|
|
///
|
|
/// The directory entries make up the rows of a table. Each resource directory
|
|
/// entry has the following format. Whether the entry is a Name or ID entry
|
|
/// is indicated by the resource directory table, which indicates how many
|
|
/// Name and ID entries follow it (remember that all the Name entries precede
|
|
/// all the ID entries for the table). All entries for the table are sorted
|
|
/// in ascending order: the Name entries by case-sensitive string and the ID
|
|
/// entries by numeric value. Offsets are relative to the address in the
|
|
/// IMAGE_DIRECTORY_ENTRY_RESOURCE DataDirectory.
|
|
/// </summary>
|
|
/// <see href="https://learn.microsoft.com/en-us/windows/win32/debug/pe-format"/>
|
|
/// <see href="https://learn.microsoft.com/en-us/previous-versions/ms809762(v=msdn.10)#pe-file-resources"/>
|
|
public sealed class DirectoryEntry
|
|
{
|
|
#region Offset 0x00
|
|
|
|
/// <summary>
|
|
/// The offset of a string that gives the Type, Name, or Language ID entry,
|
|
/// depending on level of table.
|
|
/// </summary>
|
|
/// <remarks>Must be unset if <see cref="IntegerID"/> is set</remarks>
|
|
public uint NameOffset { get; set; }
|
|
|
|
/// <summary>
|
|
/// A string that gives the Type, Name, or Language ID entry, depending on
|
|
/// level of table.
|
|
/// </summary>
|
|
/// <remarks>Only has a value if <see cref="NameOffset"/> is set</remarks>
|
|
public DirectoryString? Name { get; set; }
|
|
|
|
/// <summary>
|
|
/// A 32-bit integer that identifies the Type, Name, or Language ID entry.
|
|
/// </summary>
|
|
/// <remarks>Must be unset if <see cref="NameOffset"/> is set</remarks>
|
|
public uint IntegerID { get; set; }
|
|
|
|
#endregion
|
|
|
|
#region Offset 0x04
|
|
|
|
/// <summary>
|
|
/// High bit 0. Address of a Resource Data entry (a leaf).
|
|
/// </summary>
|
|
/// <remarks>Must be unset if <see cref="SubdirectoryOffset"/> is set</remarks>
|
|
public uint DataEntryOffset { get; set; }
|
|
|
|
/// <summary>
|
|
/// High bit 1. The lower 31 bits are the address of another resource
|
|
/// directory table (the next level down).
|
|
/// </summary>
|
|
/// <remarks>Must be unset if <see cref="DataEntryOffset"/> is set</remarks>
|
|
public uint SubdirectoryOffset { get; set; }
|
|
|
|
#endregion
|
|
|
|
/// <summary>
|
|
/// Resource data entry (a leaf).
|
|
/// </summary>
|
|
/// <remarks>Must be null if <see cref="Subdirectory"/> is set</remarks>
|
|
public DataEntry? DataEntry { get; set; }
|
|
|
|
/// <summary>
|
|
/// Another resource directory table (the next level down).
|
|
/// </summary>
|
|
/// <remarks>Must be null if <see cref="DataEntry"/> is set</remarks>
|
|
public DirectoryTable? Subdirectory { get; set; }
|
|
}
|
|
}
|