TianoCore EDK2 master
|
#include <Protocol/HiiImage.h>
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 }} |
Variables | |
EFI_GUID | gEfiHiiImageExProtocolGuid |
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
Definition in file HiiImageEx.h.
#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 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.
This | A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance. |
Flags | Describes how the image is to be drawn. |
Image | Points to the image to be displayed. |
Blt | If 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. |
BltX | Specifies the offset from the left and top edge of the output image of the first pixel in the image. |
BltY | Specifies the offset from the left and top edge of the output image of the first pixel in the image. |
EFI_SUCCESS | The image was successfully drawn. |
EFI_OUT_OF_RESOURCES | Unable to allocate an output buffer for Blt. |
EFI_INVALID_PARAMETER | The Image or Blt was NULL. |
Definition at line 144 of file HiiImageEx.h.
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.
This | A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance. |
Flags | Describes how the image is to be drawn. |
PackageList | The package list in the HII database to search for the specified image. |
ImageId | The image's id, which is unique within PackageList. |
Blt | If 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. |
BltX | Specifies the offset from the left and top edge of the output image of the first pixel in the image. |
BltY | Specifies the offset from the left and top edge of the output image of the first pixel in the image. |
EFI_SUCCESS | The image was successfully drawn. |
EFI_OUT_OF_RESOURCES | Unable to allocate an output buffer for Blt. |
EFI_INVALID_PARAMETER | The Blt was NULL or ImageId was 0. |
EFI_NOT_FOUND | The 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.
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.
This | A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance. |
PackageList | The package list in the HII database to search for the specified image. |
ImageId | The image's id, which is unique within PackageList. |
Image | Points to the image. |
EFI_SUCCESS | The new image was returned successfully. |
EFI_NOT_FOUND | The image specified by ImageId is not available. The specified PackageList is not in the Database. |
EFI_INVALID_PARAMETER | Image was NULL or ImageId was 0. |
EFI_OUT_OF_RESOURCES | The bitmap could not be retrieved because there was not enough memory. |
Definition at line 79 of file HiiImageEx.h.
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.
This | A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance. |
PackageList | Handle of the package list where this image will be searched. |
ImageId | The image's id, which is unique within PackageList. |
Image | Points to the image. |
EFI_SUCCESS | The new image was returned successfully. |
EFI_NOT_FOUND | The image specified by ImageId is not in the database. The specified PackageList is not in the database. |
EFI_BUFFER_TOO_SMALL | The buffer specified by ImageSize is too small to hold the image. |
EFI_INVALID_PARAMETER | The Image was NULL or the ImageId was 0. |
EFI_OUT_OF_RESOURCES | The bitmap could not be retrieved because there was not enough memory. |
Definition at line 226 of file HiiImageEx.h.
typedef struct _EFI_HII_IMAGE_EX_PROTOCOL EFI_HII_IMAGE_EX_PROTOCOL |
Definition at line 24 of file HiiImageEx.h.
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.
This | A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance. |
PackageList | Handle of the package list where this image will be added. |
ImageId | On return, contains the new image id, which is unique within PackageList. |
Image | Points to the image. |
EFI_SUCCESS | The new image was added successfully. |
EFI_NOT_FOUND | The specified PackageList could not be found in database. |
EFI_OUT_OF_RESOURCES | Could not add the image due to lack of resources. |
EFI_INVALID_PARAMETER | Image is NULL or ImageId is NULL. |
Definition at line 45 of file HiiImageEx.h.
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.
This | A pointer to the EFI_HII_IMAGE_EX_PROTOCOL instance. |
PackageList | The package list containing the images. |
ImageId | The image's id, which is unique within PackageList. |
Image | Points to the image. |
EFI_SUCCESS | The new image was successfully updated. |
EFI_NOT_FOUND | The image specified by ImageId is not in the database. The specified PackageList is not in the database. |
EFI_INVALID_PARAMETER | The Image was NULL, the ImageId was 0 or the Image->Bitmap was NULL. |
Definition at line 107 of file HiiImageEx.h.