windows-nt/Source/XPSP1/NT/public/internal/base/inc/setupblk.h
2020-09-26 16:20:57 +08:00

632 lines
15 KiB
C

#ifndef _SETUPBLK_
#define _SETUPBLK_
//
// Filetypes for files in txtsetup.oem.
//
typedef enum {
HwFileDriver,
HwFilePort,
HwFileClass,
HwFileInf,
HwFileDll,
HwFileDetect,
HwFileHal,
HwFileCatalog,
HwFileMax,
HwFileDynUpdt = 31
} HwFileType;
#define FILETYPE(FileType) (1 << (FileType))
#define SET_FILETYPE_PRESENT(BitArray,FileType) ((BitArray) |= FILETYPE(FileType))
#define IS_FILETYPE_PRESENT(BitArray,FileType) ((BitArray) & FILETYPE(FileType))
//
// Registry data types for registry data in txtsetup.oem.
//
typedef enum {
HwRegistryDword,
HwRegistryBinary,
HwRegistrySz,
HwRegistryExpandSz,
HwRegistryMultiSz,
HwRegistryMax
} HwRegistryType;
//
// Component types.
//
typedef enum {
HwComponentComputer,
HwComponentDisplay,
HwComponentKeyboard,
HwComponentLayout,
HwComponentMouse,
HwComponentMax
} HwComponentType;
typedef struct _PNP_HARDWARE_ID {
struct _PNP_HARDWARE_ID *Next;
//
// String that represents the hardware id of a PNP device.
//
PCHAR Id;
//
// Driver for the device
//
PCHAR DriverName;
//
// GUID for this device, if any
//
PCHAR ClassGuid;
} PNP_HARDWARE_ID, *PPNP_HARDWARE_ID;
typedef struct _DETECTED_DEVICE_REGISTRY {
struct _DETECTED_DEVICE_REGISTRY *Next;
//
// The name of the key. The empty string means the key in the
// services key itself.
//
PCHAR KeyName;
//
// The name of the value within the registry key
//
PCHAR ValueName;
//
// The data type for the value (ie, REG_DWORD, etc)
//
ULONG ValueType;
//
// The buffer containing the data to be placed into the value.
// If the ValueType is REG_SZ, then Buffer should point to
// a nul-terminated ASCII string (ie, not unicode), and BufferSize
// should be the length in bytes of that string (plus 1 for the nul).
//
PVOID Buffer;
//
// The size of the buffer in bytes
//
ULONG BufferSize;
} DETECTED_DEVICE_REGISTRY, *PDETECTED_DEVICE_REGISTRY;
//
// One of these will be created for each file to be copied for a
// third party device.
//
typedef struct _DETECTED_DEVICE_FILE {
struct _DETECTED_DEVICE_FILE *Next;
//
// Filename of the file.
//
PCHAR Filename;
//
// type of the file (hal, port, class, etc).
//
HwFileType FileType;
//
// Part of name of the section in txtsetup.oem [Config.<ConfigName>]
// that contains registry options. If this is NULL, then no registry
// information is associated with this file.
//
PCHAR ConfigName;
//
// Registry values for the node in the services list in the registry.
//
PDETECTED_DEVICE_REGISTRY RegistryValueList;
//
// These two fields are used when prompting for the diskette
// containing the third-party-supplied driver's files.
//
PTCHAR DiskDescription;
PCHAR DiskTagfile;
//
// Directory where files are to be found on the disk.
//
PCHAR Directory;
//
// Arc device name from which this file was loaded
//
PCHAR ArcDeviceName;
} DETECTED_DEVICE_FILE, *PDETECTED_DEVICE_FILE;
//
// structure for storing information about a driver we have located and
// will install.
//
typedef struct _DETECTED_DEVICE {
struct _DETECTED_DEVICE *Next;
//
// String used as a key into the relevent section (like [Display],
// [Mouse], etc).
//
PCHAR IdString;
//
// 0-based order that this driver is listed in txtsetup.sif.
// (ULONG)-1 for unsupported (ie, third party) scsi devices.
//
ULONG Ordinal;
//
// String that describes the hardware.
//
PTCHAR Description;
//
// If this is TRUE, then there is an OEM option selected for this
// hardware.
//
BOOLEAN ThirdPartyOptionSelected;
//
// Bits to be set if a third party option is selected, indicating
// which type of files are specified in the oem inf file.
//
ULONG FileTypeBits;
//
// Files for a third party option.
//
PDETECTED_DEVICE_FILE Files;
//
// For first party files loaded by the boot loader,
// this value will be the "BaseDllName" -- ie, the filename
// part only of the file from which the driver was loaded.
//
// This field is only filled in in certain cases, so be careful
// when using it. See ntos\boot\setup\setup.c. (Always filled in
// for SCSI devices.)
//
PCHAR BaseDllName;
//
// If this is TRUE, then there is a migrated driver for this
// hardware.
//
BOOLEAN MigratedDriver;
//
// Device's PNP hardware IDs (if any)
//
PPNP_HARDWARE_ID HardwareIds;
} DETECTED_DEVICE, *PDETECTED_DEVICE;
//
// Virtual OEM source devices (containing F6 drivers)
//
typedef struct _DETECTED_OEM_SOURCE_DEVICE *PDETECTED_OEM_SOURCE_DEVICE;
typedef struct _DETECTED_OEM_SOURCE_DEVICE {
PDETECTED_OEM_SOURCE_DEVICE Next;
PSTR ArcDeviceName;
PVOID ImageBase;
ULONGLONG ImageSize;
} DETECTED_OEM_SOURCE_DEVICE;
//
// Name of txtsetup.oem
//
#define TXTSETUP_OEM_FILENAME "txtsetup.oem"
#define TXTSETUP_OEM_FILENAME_U L"txtsetup.oem"
//
// Name of sections in txtsetup.oem. These are not localized.
//
#define TXTSETUP_OEM_DISKS "Disks"
#define TXTSETUP_OEM_DISKS_U L"Disks"
#define TXTSETUP_OEM_DEFAULTS "Defaults"
#define TXTSETUP_OEM_DEFAULTS_U L"Defaults"
//
// Available names of components in the defaults sections
//
#define TXTSETUP_OEM_DEFAULTS_COMPUTER "computer"
#define TXTSETUP_OEM_DEFAULTS_COMPUTER_U L"computer"
#define TXTSETUP_OEM_DEFAULTS_SCSI "scsi"
#define TXTSETUP_OEM_DEFAULTS_SCSI_U L"scsi"
//
// Field offsets in txtsetup.oem
//
// in [Disks] section
#define OINDEX_DISKDESCR 0
#define OINDEX_TAGFILE 1
#define OINDEX_DIRECTORY 2
// in [Defaults] section
#define OINDEX_DEFAULT 0
// in [<component_name>] section (ie, [keyboard])
#define OINDEX_DESCRIPTION 0
// in [Files.<compoment_name>.<id>] section (ie, [Files.Keyboard.Oem1])
#define OINDEX_DISKSPEC 0
#define OINDEX_FILENAME 1
#define OINDEX_CONFIGNAME 2
// in [Config.<compoment_name>.<id>] section (ie, [Config.Keyboard.Oem1])
#define OINDEX_KEYNAME 0
#define OINDEX_VALUENAME 1
#define OINDEX_VALUETYPE 2
#define OINDEX_FIRSTVALUE 3
// in [HardwareIds.<compoment_name>.<id>] section (ie, [HardwareIds.Keyboard.Oem1])
#define OINDEX_HW_ID 0
#define OINDEX_DRIVER_NAME 1
#define OINDEX_CLASS_GUID 2
typedef enum {
SetupOperationSetup,
SetupOperationUpgrade,
SetupOperationRepair
} SetupOperation;
typedef struct _SETUP_LOADER_BLOCK_SCALARS {
//
// This value indicates the operation we are performing
// as chosen by the user or discovered by setupldr.
//
unsigned SetupOperation;
//
// In some cases we will ask the user whether he wants
// a CD-ROM or floppy-based installation. This flag
// indicates whether he chose a CD-ROM setup.
//
unsigned SetupFromCdRom : 1;
//
// If this flag is set, then setupldr loaded scsi miniport drivers
// and the scsi class drivers we may need (scsidisk, scsicdrm, scsiflop).
//
unsigned LoadedScsi : 1;
//
// If this flag is set, then setupldr loaded non-scsi floppy class drivers
// (ie, floppy.sys) and fastfat.sys.
//
unsigned LoadedFloppyDrivers : 1;
//
// If this flag is set, then setupldr loaded non-scsi disk class drivers
// (ie, atdisk, abiosdsk, delldsa, cpqarray) and filesystems (fat, hpfs, ntfs).
//
unsigned LoadedDiskDrivers : 1;
//
// If this flag is set, then setupldr loaded non-scsi cdrom class drivers
// (currently there are none) and cdfs.
//
unsigned LoadedCdRomDrivers : 1;
//
// If this flag is set, then setupldr loaded all filesystems listed
// in [FileSystems], on txtsetup.sif.
//
unsigned LoadedFileSystems : 1;
} SETUP_LOADER_BLOCK_SCALARS, *PSETUP_LOADER_BLOCK_SCALARS;
//
// Purely arbitrary, but all net boot components enforce this. The only
// problem is if a detected Hal name is greater than this, things get ugly if
// the first MAX_HAL_NAME_LENGTH characters are identical for two different hals.
// NOTE: If you change this, change the definition in private\sm\server\smsrvp.h
// NOTE: If you change this, change the definition in private\inc\oscpkt.h
//
#define MAX_HAL_NAME_LENGTH 30
//
// This definition must match the OSC_ADMIN_PASSWORD_LEN definition in oscpkt.h
// We just define it here to avoid having to drag in oscpkt.h in every location
// that uses setupblk.h
//
#define NETBOOT_ADMIN_PASSWORD_LEN 64
typedef struct _SETUP_LOADER_BLOCK {
//
// ARC path to the Setup source media.
// The Setup boot media path is given by the
// ArcBootDeviceName field in the loader block itself.
//
PCHAR ArcSetupDeviceName;
//
// Detected/loaded video device.
//
DETECTED_DEVICE VideoDevice;
//
// Detected/loaded keyboard device.
//
PDETECTED_DEVICE KeyboardDevices;
//
// Detected computer type.
//
DETECTED_DEVICE ComputerDevice;
//
// Detected/loaded scsi adapters. This is a linked list
// because there could be multiple adapters.
//
PDETECTED_DEVICE ScsiDevices;
//
// Detected virtual OEM source devices
//
PDETECTED_OEM_SOURCE_DEVICE OemSourceDevices;
//
// Non-pointer values.
//
SETUP_LOADER_BLOCK_SCALARS ScalarValues;
//
// Pointer to the txtsetup.sif file loaded by setupldr
//
PCHAR IniFile;
ULONG IniFileLength;
//
// Pointer to the winnt.sif file loaded by setupldr
//
PCHAR WinntSifFile;
ULONG WinntSifFileLength;
//
// Pointer to the migrate.inf file loaded by setupldr
//
PCHAR MigrateInfFile;
ULONG MigrateInfFileLength;
//
// Pointer to the unsupdrv.inf file loaded by setupldr
//
PCHAR UnsupDriversInfFile;
ULONG UnsupDriversInfFileLength;
//
// Bootfont.bin file image loaded by setupldr
//
PVOID BootFontFile;
ULONG BootFontFileLength;
// On non-vga displays, setupldr looks in the firmware config tree
// for the monitor peripheral that should be a child of the
// display controller for the display being used during installation.
// It copies its monitor configuration data to allow setup to
// set the mode properly later.
//
PMONITOR_CONFIGURATION_DATA Monitor;
PCHAR MonitorId;
#ifdef _ALPHA_
//
// if alpha, then we need to know if the user supplied an OEM PAL disk
//
PDETECTED_DEVICE OemPal;
#endif
//
// Loaded boot bus extenders
//
PDETECTED_DEVICE BootBusExtenders;
//
// Loaded bus extenders
//
PDETECTED_DEVICE BusExtenders;
//
// Loaded support drivers for input devices
//
PDETECTED_DEVICE InputDevicesSupport;
//
// This is a linked list that the contains the hardware id database,
// that will be used during the initialization phase of textmode
// setup (setupdd.sys)
//
PPNP_HARDWARE_ID HardwareIdDatabase;
//
// Remote boot information.
//
WCHAR ComputerName[64];
ULONG IpAddress;
ULONG SubnetMask;
ULONG ServerIpAddress;
ULONG DefaultRouter;
ULONG DnsNameServer;
//
// The PCI hardware ID we got from the ROM of the netboot card
// ("PCI\VEN_xxx...").
//
WCHAR NetbootCardHardwareId[64];
//
// The name of the netboot card driver ("abc.sys").
//
WCHAR NetbootCardDriverName[24];
//
// The name of the netboot card service key in the registry.
//
WCHAR NetbootCardServiceName[24];
#if defined(REMOTE_BOOT)
//
// The inbound SPI, outbound SPI, and session key for the
// IPSEC conversation with the server.
//
ULONG IpsecInboundSpi;
ULONG IpsecOutboundSpi;
ULONG IpsecSessionKey;
#endif // defined(REMOTE_BOOT)
//
// If non-NULL this points to a string containing registry values to
// be added for the netboot card. The string consists of a series of
// name\0type\0value\0, with a final \0 at the end.
//
PCHAR NetbootCardRegistry;
ULONG NetbootCardRegistryLength;
//
// If non-NULL this points to the PCI or ISAPNP information about
// the netboot card.
//
PCHAR NetbootCardInfo;
ULONG NetbootCardInfoLength;
//
// Various flags.
//
ULONG Flags;
#define SETUPBLK_FLAGS_IS_REMOTE_BOOT 0x00000001
#define SETUPBLK_FLAGS_IS_TEXTMODE 0x00000002
#if defined(REMOTE_BOOT)
#define SETUPBLK_FLAGS_REPIN 0x00000004
#define SETUPBLK_FLAGS_DISABLE_CSC 0x00000008
#define SETUPBLK_FLAGS_DISCONNECTED 0x00000010
#define SETUPBLK_FLAGS_FORMAT_NEEDED 0x00000020
#define SETUPBLK_FLAGS_IPSEC_ENABLED 0x00000040
#endif // defined(REMOTE_BOOT)
#define SETUPBLK_FLAGS_CONSOLE 0x00000080
#if defined(REMOTE_BOOT)
#define SETUPBLK_FLAGS_PIN_NET_DRIVER 0x00000100
#endif // defined(REMOTE_BOOT)
#define SETUPBLK_FLAGS_REMOTE_INSTALL 0x00000200
#define SETUPBLK_FLAGS_SYSPREP_INSTALL 0x00000400
#define SETUPBLK_XINT13_SUPPORT 0x00000800
#define SETUPBLK_FLAGS_ROLLBACK 0x00001000
#if defined(REMOTE_BOOT)
//
// HAL file name.
//
CHAR NetBootHalName[MAX_HAL_NAME_LENGTH + 1];
#endif // defined(REMOTE_BOOT)
//
// During remote boot textmode setup, NtBootPath in the loader block points
// to the setup source location. We also need to pass in the path to the
// machine directory. This will be in the format \server\share\path.
//
PCHAR MachineDirectoryPath;
//
// Holds the name of the .sif file used by a remote boot machine
// during textmode setup -- this is a temp file that needs to be
// deleted. This will be in the format \server\share\path.
//
PCHAR NetBootSifPath;
//
// On a remote boot, this is information from the secret used
// when the redirector logs on.
//
PVOID NetBootSecret;
#if defined(REMOTE_BOOT)
//
// This indicates whether TFTP needed to use the second password in
// the secret to log on (as a hint to the redirector).
//
BOOLEAN NetBootUsePassword2;
#endif // defined(REMOTE_BOOT)
//
// This is the UNC path that a SysPrep installation or a machine replacement
// senario is supposed to connect to find IMirror.dat
//
UCHAR NetBootIMirrorFilePath[260];
//
// Pointer to the asrpnp.sif file loaded by setupldr
//
PCHAR ASRPnPSifFile;
ULONG ASRPnPSifFileLength;
//
// This is the administrator password supplied by the user during a
// remote install
UCHAR NetBootAdministratorPassword[NETBOOT_ADMIN_PASSWORD_LEN];
} SETUP_LOADER_BLOCK, *PSETUP_LOADER_BLOCK;
#endif // _SETUPBLK_