Display (microsoft-windows-setup-display)
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>