UEFI DXE driver to take screenshots from GOP-compatible graphic consoles
C C++
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
CrScreenshotDxe.c Add files Jan 4, 2016
CrScreenshotDxe.inf Update CrScreenshotDxe.inf Jan 4, 2016
LICENSE Initial commit Jan 4, 2016
README.md Update README.md Jan 4, 2016
lodepng.c Add files Jan 4, 2016
lodepng.h Add files Jan 4, 2016
qsort.c Add files Jan 4, 2016

README.md

CrScreenshotDxe

UEFI DXE driver to take screenshots from GOP-compatible graphic consoles.

This blog post in Russian explains more, here is just a description and usage.

Description

This DXE driver tries to register keyboard shortcut (LCtrl + LAlt + F12) handler for all text input devices. The handler tries to find a writable FS, enumerates all GOP-capable video devices, takes screenshots from them and saves the result as PNG files on that writable FS.

The main goal is to be able to make BIOS Setup screenshots for systems without serial console redirection support, but it can also be used to take screenshot from UEFI shell, UEFI apps and UEFI bootloaders.

To start the driver, you can either:

  • Integrate it into DXE volume of your UEFI firmware using UEFITool or any other suitable software (don't forget a DepEx section to prevent too early start)
  • Add it to an OptionROM of a PCIe device (will try it once I have a device needed)
  • Let BDS dispatcher load it by copying it to ESP and creating a DriverXXXX variable
  • Load it from UEFI Shell with load command

Build

It's a normal EDK2-compatible DXE driver, just add it to your package's DSC file to include in the build process.

Usage

Load the driver, insert FAT32-formatted USB drive and press LCtrl + LAlt + F12 to take screenshots from all GOP-compatible graphic consoles available at the moment.

To indicate it's status, the driver shows a small colored rectangle in top-left corner of the screen for half a second.

Rectangle color codes:

  • White - driver is loaded
  • Yellow - no writable FS found, screenshot is not taken
  • Blue - current GOP is pitch black, screenshot is not taken
  • Red - something went wrong, screenshot is not taken
  • Green - screnshot taken and saved to PNG file