TianoCore EDK2 master
Loading...
Searching...
No Matches
HiiImageEx.h File Reference

Go to the source code of this file.

Data Structures

struct  _EFI_HII_IMAGE_EX_PROTOCOL
 

Macros

#define EFI_HII_IMAGE_EX_PROTOCOL_GUID    {0x1a1241e6, 0x8f19, 0x41a9, { 0xbc, 0xe, 0xe8, 0xef, 0x39, 0xe0, 0x65, 0x46 }}
 

Typedefs

typedef struct _EFI_HII_IMAGE_EX_PROTOCOL EFI_HII_IMAGE_EX_PROTOCOL
 
typedef EFI_STATUS(EFIAPI * EFI_HII_NEW_IMAGE_EX) (IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This, IN EFI_HII_HANDLE PackageList, OUT EFI_IMAGE_ID *ImageId, IN CONST EFI_IMAGE_INPUT *Image)
 
typedef EFI_STATUS(EFIAPI * EFI_HII_GET_IMAGE_EX) (IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This, IN EFI_HII_HANDLE PackageList, IN EFI_IMAGE_ID ImageId, OUT EFI_IMAGE_INPUT *Image)
 
typedef EFI_STATUS(EFIAPI * EFI_HII_SET_IMAGE_EX) (IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This, IN EFI_HII_HANDLE PackageList, IN EFI_IMAGE_ID ImageId, IN CONST EFI_IMAGE_INPUT *Image)
 
typedef EFI_STATUS(EFIAPI * EFI_HII_DRAW_IMAGE_EX) (IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This, IN EFI_HII_DRAW_FLAGS Flags, IN CONST EFI_IMAGE_INPUT *Image, IN OUT EFI_IMAGE_OUTPUT **Blt, IN UINTN BltX, IN UINTN BltY)
 
typedef EFI_STATUS(EFIAPI * EFI_HII_DRAW_IMAGE_ID_EX) (IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This, IN EFI_HII_DRAW_FLAGS Flags, IN EFI_HII_HANDLE PackageList, IN EFI_IMAGE_ID ImageId, IN OUT EFI_IMAGE_OUTPUT **Blt, IN UINTN BltX, IN UINTN BltY)
 
typedef EFI_STATUS(EFIAPI * EFI_HII_GET_IMAGE_INFO) (IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This, IN EFI_HII_HANDLE PackageList, IN EFI_IMAGE_ID ImageId, OUT EFI_IMAGE_OUTPUT *Image)
 

Variables

EFI_GUID gEfiHiiImageExProtocolGuid
 

Detailed Description

Protocol which allows access to the images in the images database.

(C) Copyright 2016-2018 Hewlett Packard Enterprise Development LP

SPDX-License-Identifier: BSD-2-Clause-Patent

Revision Reference:
This Protocol was introduced in UEFI Specification 2.6.

Definition in file HiiImageEx.h.

Macro Definition Documentation

◆ EFI_HII_IMAGE_EX_PROTOCOL_GUID

#define EFI_HII_IMAGE_EX_PROTOCOL_GUID    {0x1a1241e6, 0x8f19, 0x41a9, { 0xbc, 0xe, 0xe8, 0xef, 0x39, 0xe0, 0x65, 0x46 }}

Definition at line 21 of file HiiImageEx.h.

Typedef Documentation

◆ EFI_HII_DRAW_IMAGE_EX

typedef EFI_STATUS(EFIAPI * EFI_HII_DRAW_IMAGE_EX) (IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This, IN EFI_HII_DRAW_FLAGS Flags, IN CONST EFI_IMAGE_INPUT *Image, IN OUT EFI_IMAGE_OUTPUT **Blt, IN UINTN BltX, IN UINTN BltY)

Renders an image to a bitmap or to the display.

The prototype of this extension function is the same with EFI_HII_IMAGE_PROTOCOL.DrawImage(). This protocol invokes EFI_HII_IMAGE_PROTOCOL.DrawImage() implicitly.

Parameters
ThisA pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.
FlagsDescribes how the image is to be drawn.
ImagePoints to the image to be displayed.
BltIf this points to a non-NULL on entry, this points to the image, which is Width pixels wide and Height pixels high. The image will be drawn onto this image and EFI_HII_DRAW_FLAG_CLIP is implied. If this points to a NULL on entry, then a buffer will be allocated to hold the generated image and the pointer updated on exit. It is the caller's responsibility to free this buffer.
BltXSpecifies the offset from the left and top edge of the output image of the first pixel in the image.
BltYSpecifies the offset from the left and top edge of the output image of the first pixel in the image.
Return values
EFI_SUCCESSThe image was successfully drawn.
EFI_OUT_OF_RESOURCESUnable to allocate an output buffer for Blt.
EFI_INVALID_PARAMETERThe Image or Blt was NULL.

Definition at line 144 of file HiiImageEx.h.

◆ EFI_HII_DRAW_IMAGE_ID_EX

typedef EFI_STATUS(EFIAPI * EFI_HII_DRAW_IMAGE_ID_EX) (IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This, IN EFI_HII_DRAW_FLAGS Flags, IN EFI_HII_HANDLE PackageList, IN EFI_IMAGE_ID ImageId, IN OUT EFI_IMAGE_OUTPUT **Blt, IN UINTN BltX, IN UINTN BltY)

Renders an image to a bitmap or the screen containing the contents of the specified image.

This function is similar to EFI_HII_IMAGE_PROTOCOL.DrawImageId(). The difference is that this function will locate all EFI_HII_IMAGE_DECODER_PROTOCOL instances installed in the system if the decoder of the certain image type is not supported by the EFI_HII_IMAGE_EX_PROTOCOL. The function will attempt to decode the image to the EFI_IMAGE_INPUT using the first EFI_HII_IMAGE_DECODER_PROTOCOL instance that supports the requested image type.

Parameters
ThisA pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.
FlagsDescribes how the image is to be drawn.
PackageListThe package list in the HII database to search for the specified image.
ImageIdThe image's id, which is unique within PackageList.
BltIf this points to a non-NULL on entry, this points to the image, which is Width pixels wide and Height pixels high. The image will be drawn onto this image and EFI_HII_DRAW_FLAG_CLIP is implied. If this points to a NULL on entry, then a buffer will be allocated to hold the generated image and the pointer updated on exit. It is the caller's responsibility to free this buffer.
BltXSpecifies the offset from the left and top edge of the output image of the first pixel in the image.
BltYSpecifies the offset from the left and top edge of the output image of the first pixel in the image.
Return values
EFI_SUCCESSThe image was successfully drawn.
EFI_OUT_OF_RESOURCESUnable to allocate an output buffer for Blt.
EFI_INVALID_PARAMETERThe Blt was NULL or ImageId was 0.
EFI_NOT_FOUNDThe image specified by ImageId is not in the database. The specified PackageList is not in the database.

Definition at line 191 of file HiiImageEx.h.

◆ EFI_HII_GET_IMAGE_EX

typedef EFI_STATUS(EFIAPI * EFI_HII_GET_IMAGE_EX) (IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This, IN EFI_HII_HANDLE PackageList, IN EFI_IMAGE_ID ImageId, OUT EFI_IMAGE_INPUT *Image)

Return the information about the image, associated with the package list. The prototype of this extension function is the same with EFI_HII_IMAGE_PROTOCOL.GetImage().

This function is similar to EFI_HII_IMAGE_PROTOCOL.GetImage().The difference is that this function will locate all EFI_HII_IMAGE_DECODER_PROTOCOL instances installed in the system if the decoder of the certain image type is not supported by the EFI_HII_IMAGE_EX_PROTOCOL. The function will attempt to decode the image to the EFI_IMAGE_INPUT using the first EFI_HII_IMAGE_DECODER_PROTOCOL instance that supports the requested image type.

Parameters
ThisA pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.
PackageListThe package list in the HII database to search for the specified image.
ImageIdThe image's id, which is unique within PackageList.
ImagePoints to the image.
Return values
EFI_SUCCESSThe new image was returned successfully.
EFI_NOT_FOUNDThe image specified by ImageId is not available. The specified PackageList is not in the Database.
EFI_INVALID_PARAMETERImage was NULL or ImageId was 0.
EFI_OUT_OF_RESOURCESThe bitmap could not be retrieved because there was not enough memory.

Definition at line 79 of file HiiImageEx.h.

◆ EFI_HII_GET_IMAGE_INFO

typedef EFI_STATUS(EFIAPI * EFI_HII_GET_IMAGE_INFO) (IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This, IN EFI_HII_HANDLE PackageList, IN EFI_IMAGE_ID ImageId, OUT EFI_IMAGE_OUTPUT *Image)

This function returns the image information to EFI_IMAGE_OUTPUT. Only the width and height are returned to the EFI_IMAGE_OUTPUT instead of decoding the image to the buffer. This function is used to get the geometry of the image. This function will try to locate all of the EFI_HII_IMAGE_DECODER_PROTOCOL installed on the system if the decoder of image type is not supported by the EFI_HII_IMAGE_EX_PROTOCOL.

Parameters
ThisA pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.
PackageListHandle of the package list where this image will be searched.
ImageIdThe image's id, which is unique within PackageList.
ImagePoints to the image.
Return values
EFI_SUCCESSThe new image was returned successfully.
EFI_NOT_FOUNDThe image specified by ImageId is not in the database. The specified PackageList is not in the database.
EFI_BUFFER_TOO_SMALLThe buffer specified by ImageSize is too small to hold the image.
EFI_INVALID_PARAMETERThe Image was NULL or the ImageId was 0.
EFI_OUT_OF_RESOURCESThe bitmap could not be retrieved because there was not enough memory.

Definition at line 226 of file HiiImageEx.h.

◆ EFI_HII_IMAGE_EX_PROTOCOL

Definition at line 24 of file HiiImageEx.h.

◆ EFI_HII_NEW_IMAGE_EX

typedef EFI_STATUS(EFIAPI * EFI_HII_NEW_IMAGE_EX) (IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This, IN EFI_HII_HANDLE PackageList, OUT EFI_IMAGE_ID *ImageId, IN CONST EFI_IMAGE_INPUT *Image)

The prototype of this extension function is the same with EFI_HII_IMAGE_PROTOCOL.NewImage(). This protocol invokes EFI_HII_IMAGE_PROTOCOL.NewImage() implicitly.

Parameters
ThisA pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.
PackageListHandle of the package list where this image will be added.
ImageIdOn return, contains the new image id, which is unique within PackageList.
ImagePoints to the image.
Return values
EFI_SUCCESSThe new image was added successfully.
EFI_NOT_FOUNDThe specified PackageList could not be found in database.
EFI_OUT_OF_RESOURCESCould not add the image due to lack of resources.
EFI_INVALID_PARAMETERImage is NULL or ImageId is NULL.

Definition at line 45 of file HiiImageEx.h.

◆ EFI_HII_SET_IMAGE_EX

typedef EFI_STATUS(EFIAPI * EFI_HII_SET_IMAGE_EX) (IN CONST EFI_HII_IMAGE_EX_PROTOCOL *This, IN EFI_HII_HANDLE PackageList, IN EFI_IMAGE_ID ImageId, IN CONST EFI_IMAGE_INPUT *Image)

Change the information about the image.

Same with EFI_HII_IMAGE_PROTOCOL.SetImage(),this protocol invokes EFI_HII_IMAGE_PROTOCOL.SetImage()implicitly.

Parameters
ThisA pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance.
PackageListThe package list containing the images.
ImageIdThe image's id, which is unique within PackageList.
ImagePoints to the image.
Return values
EFI_SUCCESSThe new image was successfully updated.
EFI_NOT_FOUNDThe image specified by ImageId is not in the database. The specified PackageList is not in the database.
EFI_INVALID_PARAMETERThe Image was NULL, the ImageId was 0 or the Image->Bitmap was NULL.

Definition at line 107 of file HiiImageEx.h.