BcdOSLoaderElementTypes enumeration

  • Article

Specifies the operating system loader element types.

Syntax

typedef enum BcdOSLoaderElementTypes { 
  BcdOSLoaderDevice_OSDevice                        = 0x21000001,
  BcdOSLoaderString_SystemRoot                      = 0x22000002,
  BcdOSLoaderObject_AssociatedResumeObject          = 0x23000003,
  BcdOSLoaderBoolean_DetectKernelAndHal             = 0x26000010,
  BcdOSLoaderString_KernelPath                      = 0x22000011,
  BcdOSLoaderString_HalPath                         = 0x22000012,
  BcdOSLoaderString_DbgTransportPath                = 0x22000013,
  BcdOSLoaderInteger_NxPolicy                       = 0x25000020,
  BcdOSLoaderInteger_PAEPolicy                      = 0x25000021,
  BcdOSLoaderBoolean_WinPEMode                      = 0x26000022,
  BcdOSLoaderBoolean_DisableCrashAutoReboot         = 0x26000024,
  BcdOSLoaderBoolean_UseLastGoodSettings            = 0x26000025,
  BcdOSLoaderBoolean_AllowPrereleaseSignatures      = 0x26000027,
  BcdOSLoaderBoolean_NoLowMemory                    = 0x26000030,
  BcdOSLoaderInteger_RemoveMemory                   = 0x25000031,
  BcdOSLoaderInteger_IncreaseUserVa                 = 0x25000032,
  BcdOSLoaderBoolean_UseVgaDriver                   = 0x26000040,
  BcdOSLoaderBoolean_DisableBootDisplay             = 0x26000041,
  BcdOSLoaderBoolean_DisableVesaBios                = 0x26000042,
  BcdOSLoaderBoolean_DisableVgaMode                 = 0x26000043,
  BcdOSLoaderInteger_ClusterModeAddressing          = 0x25000050,
  BcdOSLoaderBoolean_UsePhysicalDestination         = 0x26000051,
  BcdOSLoaderInteger_RestrictApicCluster            = 0x25000052,
  BcdOSLoaderBoolean_UseLegacyApicMode              = 0x26000054,
  BcdOSLoaderInteger_X2ApicPolicy                   = 0x25000055,
  BcdOSLoaderBoolean_UseBootProcessorOnly           = 0x26000060,
  BcdOSLoaderInteger_NumberOfProcessors             = 0x25000061,
  BcdOSLoaderBoolean_ForceMaximumProcessors         = 0x26000062,
  BcdOSLoaderBoolean_ProcessorConfigurationFlags    = 0x25000063,
  BcdOSLoaderBoolean_MaximizeGroupsCreated          = 0x26000064,
  BcdOSLoaderBoolean_ForceGroupAwareness            = 0x26000065,
  BcdOSLoaderInteger_GroupSize                      = 0x25000066,
  BcdOSLoaderInteger_UseFirmwarePciSettings         = 0x26000070,
  BcdOSLoaderInteger_MsiPolicy                      = 0x25000071,
  BcdOSLoaderInteger_SafeBoot                       = 0x25000080,
  BcdOSLoaderBoolean_SafeBootAlternateShell         = 0x26000081,
  BcdOSLoaderBoolean_BootLogInitialization          = 0x26000090,
  BcdOSLoaderBoolean_VerboseObjectLoadMode          = 0x26000091,
  BcdOSLoaderBoolean_KernelDebuggerEnabled          = 0x260000a0,
  BcdOSLoaderBoolean_DebuggerHalBreakpoint          = 0x260000a1,
  BcdOSLoaderBoolean_UsePlatformClock               = 0x260000A2,
  BcdOSLoaderBoolean_ForceLegacyPlatform            = 0x260000A3,
  BcdOSLoaderInteger_TscSyncPolicy                  = 0x250000A6,
  BcdOSLoaderBoolean_EmsEnabled                     = 0x260000b0,
  BcdOSLoaderInteger_DriverLoadFailurePolicy        = 0x250000c1,
  BcdOSLoaderInteger_BootMenuPolicy                 = 0x250000C2,
  BcdOSLoaderBoolean_AdvancedOptionsOneTime         = 0x260000C3,
  BcdOSLoaderInteger_BootStatusPolicy               = 0x250000E0,
  BcdOSLoaderBoolean_DisableElamDrivers             = 0x260000E1,
  BcdOSLoaderInteger_HypervisorLaunchType           = 0x250000F0,
  BcdOSLoaderBoolean_HypervisorDebuggerEnabled      = 0x260000F2,
  BcdOSLoaderInteger_HypervisorDebuggerType         = 0x250000F3,
  BcdOSLoaderInteger_HypervisorDebuggerPortNumber   = 0x250000F4,
  BcdOSLoaderInteger_HypervisorDebuggerBaudrate     = 0x250000F5,
  BcdOSLoaderInteger_HypervisorDebugger1394Channel  = 0x250000F6,
  BcdOSLoaderInteger_BootUxPolicy                   = 0x250000F7,
  BcdOSLoaderString_HypervisorDebuggerBusParams     = 0x220000F9,
  BcdOSLoaderInteger_HypervisorNumProc              = 0x250000FA,
  BcdOSLoaderInteger_HypervisorRootProcPerNode      = 0x250000FB,
  BcdOSLoaderBoolean_HypervisorUseLargeVTlb         = 0x260000FC,
  BcdOSLoaderInteger_HypervisorDebuggerNetHostIp    = 0x250000FD,
  BcdOSLoaderInteger_HypervisorDebuggerNetHostPort  = 0x250000FE,
  BcdOSLoaderInteger_TpmBootEntropyPolicy           = 0x25000100,
  BcdOSLoaderString_HypervisorDebuggerNetKey        = 0x22000110,
  BcdOSLoaderBoolean_HypervisorDebuggerNetDhcp      = 0x26000114,
  BcdOSLoaderInteger_HypervisorIommuPolicy          = 0x25000115,
  BcdOSLoaderInteger_XSaveDisable                   = 0x2500012b
} BcdOSLoaderElementTypes;

Constants

BcdOSLoaderDevice_OSDevice

The device on which the operating system resides. The element data format is BcdDeviceElement.

BcdOSLoaderString_SystemRoot

The file path to the operating system (%SystemRoot% minus the volume.) The element data format is BcdStringElement.

BcdOSLoaderObject_AssociatedResumeObject

The resume application associated with the operating system. The element data format is BcdObjectElement.

BcdOSLoaderBoolean_DetectKernelAndHal

Indicates whether the operating system loader should determine the kernel and HAL to load based on the platform features. The element data format is BcdBooleanElement.

BcdOSLoaderString_KernelPath

The kernel to be loaded by the operating system loader. This value overrides the default kernel. The element data format is BcdStringElement.

BcdOSLoaderString_HalPath

The HAL to be loaded by the operating system loader. This value overrides the default HAL. The element data format is BcdStringElement.

BcdOSLoaderString_DbgTransportPath

The transport DLL to be loaded by the operating system loader. This value overrides the default Kdcom.dll. The element data format is BcdStringElement.

BcdOSLoaderInteger_NxPolicy

The no-execute page protection policy. The element data format is BcdIntegerElement and the Integer property is one of the values from the BcdOSLoader_NxPolicy enumeration.

If this value is not specified, the default is NxPolicyAlwaysOff.

BcdOSLoaderInteger_PAEPolicy

The Physical Address Extension (PAE) policy. The element data format is BcdIntegerElement and the Integer property is one of the values from the BcdOSLoader_PAEPolicy enumeration.

If this value is not specified, the default is PaePolicyDefault.

BcdOSLoaderBoolean_WinPEMode

Indicates that the system should be started in Windows Preinstallation Environment (Windows PE) mode. The element data format is BcdBooleanElement.

BcdOSLoaderBoolean_DisableCrashAutoReboot

Indicates that the system should not automatically reboot when it crashes. The element data format is BcdBooleanElement.

BcdOSLoaderBoolean_UseLastGoodSettings

Indicates that the system should use the last-known good settings. The element data format is BcdBooleanElement.

BcdOSLoaderBoolean_AllowPrereleaseSignatures

Indicates whether the test code signing certificate is supported. The element data format is BcdBooleanElement.

Note This value is not supported in Windows 8 and Windows Server 2012.

BcdOSLoaderBoolean_NoLowMemory

Indicates whether the system should utilize the first 4GB of physical memory. This option requires 5GB of physical memory, and on x86 systems it requires PAE to be enabled. The element data format is BcdBooleanElement.

BcdOSLoaderInteger_RemoveMemory

The amount of memory the system should ignore. The element data format is BcdIntegerElement.

BcdOSLoaderInteger_IncreaseUserVa

The amount of memory that should be utilized by the process address space, in bytes. This value should be between 2GB and 3GB. The element data format is BcdIntegerElement.

Increasing this value from the default 2GB decreases the amount of virtual address space available to the system and device drivers.

BcdOSLoaderBoolean_UseVgaDriver

Indicates whether the system should use the standard VGA display driver instead of a high-performance display driver. The element data format is BcdBooleanElement.

BcdOSLoaderBoolean_DisableBootDisplay

Indicates whether the system should initialize the VGA driver responsible for displaying simple graphics during the boot process. If not, there is no display is presented during the boot process. The element data format is BcdBooleanElement.

Note This value should not be used in Windows 8 and Windows Server 2012.

BcdOSLoaderBoolean_DisableVesaBios

Indicates whether the VGA driver should avoid VESA BIOS calls. The element data format is BcdBooleanElement.

Note This value is ignored by Windows 8 and Windows Server 2012.

BcdOSLoaderBoolean_DisableVgaMode

Disables the use of VGA modes in the OS. The element data format is BcdBooleanElement.

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderInteger_ClusterModeAddressing

Indicates that cluster-mode APIC addressing should be utilized, and the value is the maximum number of processors per cluster. The element data format is BcdIntegerElement.

BcdOSLoaderBoolean_UsePhysicalDestination

Indicates whether to enable physical-destination mode for all APIC messages. The element data format is BcdBooleanElement.

BcdOSLoaderInteger_RestrictApicCluster

The maximum number of APIC clusters that should be used by cluster-mode addressing. The element data format is BcdIntegerElement.

BcdOSLoaderBoolean_UseLegacyApicMode

Used to force legacy APIC mode, even if the processors and chipset support extended APIC mode. The element data format is BcdBooleanElement.

BcdOSLoaderInteger_X2ApicPolicy

Enables the use of extended APIC mode, if supported. Zero (0) indicates default behavior, one (1) indicates that extended APIC mode is disabled, and two (2) indicates that extended APIC mode is enabled. The system defaults to using extended APIC mode if available. The element data format is BcdIntegerElement.

BcdOSLoaderBoolean_UseBootProcessorOnly

Indicates whether the operating system should initialize or start non-boot processors. The element data format is BcdBooleanElement.

BcdOSLoaderInteger_NumberOfProcessors

The maximum number of processors that can be utilized by the system; all other processors are ignored. The element data format is BcdIntegerElement.

BcdOSLoaderBoolean_ForceMaximumProcessors

Indicates whether the system should use the maximum number of processors. The element data format is BcdBooleanElement.

BcdOSLoaderBoolean_ProcessorConfigurationFlags

Indicates whether processor specific configuration flags are to be used. The element data format is BcdIntegerElement.

BcdOSLoaderBoolean_MaximizeGroupsCreated

Maximizes the number of groups created when assigning nodes to processor groups. The element data format is BcdBooleanElement.

BcdOSLoaderBoolean_ForceGroupAwareness

This setting makes drivers group aware and can be used to determine improper group usage. The element data format is BcdBooleanElement.

BcdOSLoaderInteger_GroupSize

Specifies the size of all processor groups. Must be set to a power of 2. The element data format is BcdIntegerElement.

BcdOSLoaderInteger_UseFirmwarePciSettings

Indicates whether the system should use I/O and IRQ resources created by the system firmware instead of using dynamically configured resources. The element data format is BcdBooleanElement.

BcdOSLoaderInteger_MsiPolicy

The PCI Message Signaled Interrupt (MSI) policy. Zero (0) indicates default, and one (1) indicates that MSI interrupts are disabled. The element data format is BcdBooleanElement.

BcdOSLoaderInteger_SafeBoot

The element data format is BcdIntegerElement and the Integer property is one of the values from the BcdLibrary_SafeBoot enumeration.

BcdOSLoaderBoolean_SafeBootAlternateShell

Indicates whether the system should use the shell specified under the following registry key instead of the default shell: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SafeBoot\AlternateShell. The element data format is BcdBooleanElement.

BcdOSLoaderBoolean_BootLogInitialization

Indicates whether the system should write logging information to %SystemRoot%\Ntbtlog.txt during initialization. The element data format is BcdBooleanElement.

BcdOSLoaderBoolean_VerboseObjectLoadMode

Indicates whether the system should display verbose information. The element data format is BcdBooleanElement.

BcdOSLoaderBoolean_KernelDebuggerEnabled

Indicates whether the kernel debugger should be enabled using the settings in the inherited debugger object. The element data format is BcdBooleanElement.

BcdOSLoaderBoolean_DebuggerHalBreakpoint

Indicates whether the HAL should call DbgBreakPoint at the start of HalInitSystem for phase 0 initialization of the kernel. The element data format is BcdBooleanElement.

BcdOSLoaderBoolean_UsePlatformClock

Forces the use of the platform clock as the system's performance counter. The element data format is BcdBooleanElement.

Note

This value should only be used for debugging.

BcdOSLoaderBoolean_ForceLegacyPlatform

Forces the OS to assume the presence of legacy PC devices like CMOS and keyboard controllers. The element data format is BcdBooleanElement.

Note

This value should only be used for debugging.

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderInteger_TscSyncPolicy

Note

This value should only be used for debugging.

Controls the TSC synchronization policy. Possible values include default (0), legacy (1), or enhanced (2). The element data format is BcdIntegerElement.

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderBoolean_EmsEnabled

Indicates whether EMS should be enabled in the kernel. The element data format is BcdBooleanElement.

BcdOSLoaderInteger_DriverLoadFailurePolicy

Indicates the driver load failure policy. Zero (0) indicates that a failed driver load is fatal and the boot will not continue, one (1) indicates that the standard error control is used. The element data format is BcdIntegerElement.

BcdOSLoaderInteger_BootMenuPolicy

Defines the type of boot menus the system will use. Possible values include menupolicylegacy (0) or menupolicystandard (1). The default value is menupolicylegacy (0). The element data format is BcdIntegerElement.

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderBoolean_AdvancedOptionsOneTime

Controls whether the system boots to the legacy menu (F8 menu) on the next boot. The element data format is BcdBooleanElement.

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderInteger_BootStatusPolicy

The boot status policy. The element data format is BcdIntegerElement.

Term Description
BootStatusPolicyDisplayAllFailures (0)
 Display all boot failures.
BootStatusPolicyIgnoreAllFailures (1)
 Ignore all boot failures.
BootStatusPolicyIgnoreShutdownFailures (2)
 Ignore all shutdown failures.
BootStatusPolicyIgnoreBootFailures (3)
 Ignore all boot failures.
BootStatusPolicyIgnoreCheckpointFailures (4)
 Ignore checkpoint failures.
BootStatusPolicyDisplayShutdownFailures (5)
 Display shutdown failures.
BootStatusPolicyDisplayBootFailures (6)
 Display boot failures.
BootStatusPolicyDisplayCheckpointFailures (7)
 Display checkpoint failures.

BcdOSLoaderBoolean_DisableElamDrivers

The OS loader removes this entry for security reasons. This option can only be triggered by using the F8 menu; a user must be physically present to trigger this option. The element data format is BcdBooleanElement.

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderInteger_HypervisorLaunchType

Controls the hypervisor launch type. Options are HyperVisorLaunchOff (0) and HypervisorLaunchAuto (1). The element data format is BcdIntegerElement.

BcdOSLoaderBoolean_HypervisorDebuggerEnabled

Controls whether the hypervisor debugger is enabled. The element data format is BcdBooleanElement.

BcdOSLoaderInteger_HypervisorDebuggerType

Controls the hypervisor debugger type. Can be set to SERIAL (0), 1394 (1), or NET (2). The element data format is BcdIntegerElement.

BcdOSLoaderInteger_HypervisorDebuggerPortNumber

Specifies the serial port number for serial debugging. The element data format is BcdIntegerElement.

If this value is not specified, the default is specified by the DBGP ACPI table settings.

BcdOSLoaderInteger_HypervisorDebuggerBaudrate

Specifies the baud rate for serial debugging. The element data format is BcdIntegerElement.

If this value is not specified, the default is specified by the DBGP ACPI table settings.

BcdOSLoaderInteger_HypervisorDebugger1394Channel

Specifies the channel number for 1394 debugging. The element data format is BcdIntegerElement.

BcdOSLoaderInteger_BootUxPolicy

Values are Disabled (0), Basic (1), and Standard (2). The element data format is BcdIntegerElement.

Note This value is no longer used in Windows 8 and Windows Server 2012.

BcdOSLoaderString_HypervisorDebuggerBusParams

Defines the PCI bus, device, and function numbers of the debugging device used with the hypervisor. For example, 1.5.0 describes the debugging device on bus 1, device 5, function 0. The element data format is BcdStringElement.

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderInteger_HypervisorNumProc

Specifies the total number of logical processors that can be started in the hypervisor. The element data format is BcdIntegerElement.

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderInteger_HypervisorRootProcPerNode

Specifies the total number of virtual processors in the root partition that can be started within a pre-split Non-Uniform Memory Architecture (NUMA) node. The element data format is BcdIntegerElement.

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderBoolean_HypervisorUseLargeVTlb

Increases virtual Translation Lookaside Buffer (TLB) size. The element data format is BcdBooleanElement.

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderInteger_HypervisorDebuggerNetHostIp

Defines the host IPv4 address for the network debugger. The element data format is BcdIntegerElement.

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderInteger_HypervisorDebuggerNetHostPort

Defines the network UDP port for the network debugger. The element data format is BcdIntegerElement.

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderInteger_TpmBootEntropyPolicy

Determines whether entropy is gathered from the trusted platform module (TPM) to help seed the random number generator in the OS. The element data format is BcdIntegerElement. Possible values are default (0), forcedisable (1), and forceenable (2).

BcdOSLoaderString_HypervisorDebuggerNetKey

Holds the key used to encrypt the network debug connection used with the hypervisor. The element data format is BcdStringElement.

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderBoolean_HypervisorDebuggerNetDhcp

Controls use of DHCP by the network debugger used with the hypervisor. Setting this to false forces local link only address. The element data format is BcdBooleanElement.

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderInteger_HypervisorIommuPolicy

Controls whether the hypervisor uses an Input Output Memory Management Unit (IOMMU). The element data format is BcdIntegerElement. Possible values are default (0), enable (1), and disable (2).

Note This value is supported starting in Windows 8 and Windows Server 2012.

BcdOSLoaderInteger_XSaveDisable

When set to a value other than zero (0), disables XSAVE functionality in the kernel. The element data format is BcdIntegerElement.

Requirements
Minimum supported client
 Windows Vista [desktop apps only]
Minimum supported server
 Windows Server 2008 [desktop apps only]

See also

BCD WMI Provider Enumerations

BcdBooleanElement

BcdIntegerElement

BcdStringElement

GetElement

BcdElementType