Share via

Display (microsoft-windows-setup-display)

  • Article

Display contains display settings for a video adapter.

The Display setting is used during the Windows PE phase of the Windows installation process. The display settings are not applied to the Windows installation. To change the display settings for the Windows installation, see Display in the Microsoft-Windows-Shell-Setup component.

We recommend that you use the default settings. If you select a value for this setting that is not supported by Windows PE, your video adapter, or the display monitor, then Windows PE might show only a blank screen without displaying an error.

Note

On UEFI-based computers, this setting is ignored unless you have added a graphics driver into the Windows PE image at \sources\boot.wim. On BIOS-based computers, by default, Windows PE uses a resolution of 1024x768. For displays with a smaller maximum resolution, Windows PE uses the largest resolution available, based on the extended display identification data (EDID) of the connected display.

Child Elements

Setting Description
ColorDepth Specifies the color depth to apply to the display device.
HorizontalResolution Specifies the horizontal resolution to apply to the display device.
RefreshRate Specifies the refresh rate to apply to the display device.
VerticalResolution Specifies the vertical resolution to apply to the display device.

Valid Configuration Passes

windowsPE

Parent Hierarchy

microsoft-windows-setup- | Display

Applies To

This setting only affects the Windows Setup process on BIOS-based computers. UEFI-based computers are not affected by these settings.

For the list of the Windows editions and architectures that this component supports, see Microsoft-Windows-Setup.

XML Example

The following XML output sets the display resolution to 1920x1080, with 16-bit color depth and a refresh rate of 60 hertz.

<Display>
   <HorizontalResolution>1920</HorizontalResolution>
   <VerticalResolution>1080</VerticalResolution>
   <ColorDepth>16</ColorDepth>
   <RefreshRate>60</RefreshRate>
</Display>

Microsoft-Windows-Setup