TianoCore EDK2 master
Loading...
Searching...
No Matches
UefiHiiServicesLib.c File Reference

Go to the source code of this file.

Functions

EFI_STATUS EFIAPI UefiHiiServicesLibConstructor (IN EFI_HANDLE ImageHandle, IN EFI_SYSTEM_TABLE *SystemTable)
 

Variables

EFI_HII_FONT_PROTOCOLgHiiFont = NULL
 
EFI_HII_STRING_PROTOCOLgHiiString = NULL
 
EFI_HII_IMAGE_PROTOCOLgHiiImage = NULL
 
EFI_HII_DATABASE_PROTOCOLgHiiDatabase = NULL
 
EFI_HII_CONFIG_ROUTING_PROTOCOLgHiiConfigRouting = NULL
 

Detailed Description

This library retrieves pointers to the UEFI HII Protocol instances in the library's constructor. All of the UEFI HII related protocols are optional, so the consumers of this library class must verify that the global variable pointers are not NULL before use.

Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file UefiHiiServicesLib.c.

Function Documentation

◆ UefiHiiServicesLibConstructor()

EFI_STATUS EFIAPI UefiHiiServicesLibConstructor ( IN EFI_HANDLE  ImageHandle,
IN EFI_SYSTEM_TABLE SystemTable 
)

The constructor function retrieves pointers to the UEFI HII protocol instances

The constructor function retrieves pointers to the four UEFI HII protocols from the handle database. These include the UEFI HII Font Protocol, the UEFI HII String Protocol, the UEFI HII Image Protocol, the UEFI HII Database Protocol, and the UEFI HII Config Routing Protocol. This function always return EFI_SUCCESS. All of these protocols are optional if the platform does not support configuration and the UEFI HII Image Protocol and the UEFI HII Font Protocol are optional if the platform does not support a graphical console. As a result, the consumers of this library much check the protocol pointers againt NULL before using them, or use dependency expressions to guarantee that some of them are present before assuming they are not NULL.

Parameters
ImageHandleThe firmware allocated handle for the EFI image.
SystemTableA pointer to the EFI System Table.
Return values
EFI_SUCCESSThe constructor always returns EFI_SUCCESS.

Definition at line 71 of file UefiHiiServicesLib.c.

Variable Documentation

◆ gHiiConfigRouting

EFI_HII_CONFIG_ROUTING_PROTOCOL* gHiiConfigRouting = NULL

Pointer to the UEFI HII Config Rounting Protocol

Definition at line 47 of file UefiHiiServicesLib.c.

◆ gHiiDatabase

Pointer to the UEFI HII Database Protocol

Definition at line 42 of file UefiHiiServicesLib.c.

◆ gHiiFont

Pointer to the UEFI HII Font Protocol

Definition at line 27 of file UefiHiiServicesLib.c.

◆ gHiiImage

Pointer to the UEFI HII Image Protocol

Definition at line 37 of file UefiHiiServicesLib.c.

◆ gHiiString

Pointer to the UEFI HII String Protocol

Definition at line 32 of file UefiHiiServicesLib.c.