4 das uefi-programmiermodell – HP Unified Extensible Firmware Interface Benutzerhandbuch
Seite 69
4 Das UEFI-Programmiermodell
Die UEFI-Shell verfügt über eine Programmierungs-API. Sie können damit eigene UEFI-Anwendungen
zum Aufrufen von Shell-Programmierungs-APIs oder -Protokollen schreiben. Weitere Informationen
enthält die UEFI-Shellspezifikation und EDK2. Die UEFI-Shell stellt eine Programmierungs-API bereit,
siehe
. EFI_SHELL_PROTOCOL stellt Shelldienste für UEFI-Anwendungen bereit.
So können UEFI-Shellanwendungen auf Low-Level-Shellfunktionen zugreifen, z. B.: Dateien, Pipes,
Umgebungsvariablen, aktuelles Arbeitsverzeichnis, Zuordnungen, Hilfetext, Aliasnamen und Starten
von Shellanwendungen und -skripts.
Tabelle 13 UEFI-Anwendungs-APIs
Beschreibung
Funktionsname
Funktionstyp
Veranlasst die Shell zum Analysieren und
Ausführen der Befehlszeile.
Execute
EFI_SHELL_EXECUTE
Ruft die Umgebungsvariable ab.
GetEnv
EFI_SHELL_GET_ENV
Ändert eine bestimmte Umgebungsvariable.
SetEnv
EFI_SHELL_SET_ENV
Ruft den Aliasnamen eines bestimmten
Shellbefehls ab.
GetAlias
EFI_SHELL_GET_ALIAS
Fügt den Aliasnamen für einen bestimmten
Shellbefehl hinzu oder entfernt ihn.
SetAlias
EFI_SHELL_SET_ALIAS
Gibt Hilfeinformationen zu einem bestimmten
Befehl zurück.
GetHelpText
EFI_SHELL_GET_HELP_TEXT
Gibt den Gerätepfad einer Zuordnung zurück.
GetDevicePathFromMap
EFI_SHELL_GET_DEVICE_PATH_FROM_MAP
Gibt die Zuordnung zurück, die einem
bestimmten Gerätepfad entspricht.
GetMapFromDevicePath
EFI_SHELL_GET_MAP_FROM_DEVICE_PATH
Konvertiert einen Dateipfad in einen
Gerätepfad, in dem alle Zuordnungen durch
entsprechende Gerätepfade ersetzt wurden.
GetDevicePathFromFilePath
EFI_SHELL_GET_DEVICE_PATH_FROM_FILE_PATH
Konvertiert einen Gerätepfad in einen
Dateipfad, in dem der einer der Zuordnungen
GetFilePathFromDevicePath
EFI_SHELL_GET_FILE_PATH_FROM_DEVICE_PATH
entsprechende Teil des Gerätepfads durch
diese Zuordnung ersetzt ist.
Erstellt/Aktualisiert/Löscht eine Zuordnung
zwischen einem Gerät und einem Gerätepfad.
SetMap
EFI_SHELL_SET_MAP
Gibt das aktuelle Verzeichnis auf einem Gerät
zurück.
GetCurDir
EFI_SHELL_GET_CUR_DIR
Wechselt das aktuelle Verzeichnis auf einem
Gerät.
SetCurDir
EFI_SHELL_SET_CUR_DIR
Öffnet die Dateien, die dem angegebenen
Pfadmuster entsprechen.
OpenFileList
EFI_SHELL_OPEN_FILE_LIST
Gibt die von OpenFileList() erstellte Dateiliste
frei.
FreeFileList
EFI_SHELL_FREE_FILE_LIST
Löscht die Duplikatdateien in der gegebenen
Dateiliste.
RemoveDupInFileList
EFI_SHELL_REMOVE_DUP_IN_FILE_LIST
Gibt an, ob derzeit Skriptdateien verarbeitet
werden.
BatchIsActive
EFI_SHELL_BATCH_IS_ACTIVE
Ermittelt, ob die aktive Shell die Stammshell
ist.
IsRootShell
EFI_SHELL_IS_ROOT_SHELL
69