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

Go to the source code of this file.

Data Structures

struct  _EFI_DEFERRED_IMAGE_LOAD_PROTOCOL
 

Macros

#define EFI_DEFERRED_IMAGE_LOAD_PROTOCOL_GUID
 

Typedefs

typedef struct _EFI_DEFERRED_IMAGE_LOAD_PROTOCOL EFI_DEFERRED_IMAGE_LOAD_PROTOCOL
 
typedef EFI_STATUS(EFIAPI * EFI_DEFERRED_IMAGE_INFO) (IN EFI_DEFERRED_IMAGE_LOAD_PROTOCOL *This, IN UINTN ImageIndex, OUT EFI_DEVICE_PATH_PROTOCOL **ImageDevicePath, OUT VOID **Image, OUT UINTN *ImageSize, OUT BOOLEAN *BootOption)
 

Variables

EFI_GUID gEfiDeferredImageLoadProtocolGuid
 

Detailed Description

UEFI 2.2 Deferred Image Load Protocol definition.

This protocol returns information about images whose load was denied because of security considerations. This information can be used by the Boot Manager or another agent to reevaluate the images when the current security profile has been changed, such as when the current user profile changes. There can be more than one instance of this protocol installed.

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

Definition in file DeferredImageLoad.h.

Macro Definition Documentation

◆ EFI_DEFERRED_IMAGE_LOAD_PROTOCOL_GUID

#define EFI_DEFERRED_IMAGE_LOAD_PROTOCOL_GUID
Value:
{ \
0x15853d7c, 0x3ddf, 0x43e0, { 0xa1, 0xcb, 0xeb, 0xf8, 0x5b, 0x8f, 0x87, 0x2c } \
};

Global ID for the Deferred Image Load Protocol

Definition at line 20 of file DeferredImageLoad.h.

Typedef Documentation

◆ EFI_DEFERRED_IMAGE_INFO

typedef EFI_STATUS(EFIAPI * EFI_DEFERRED_IMAGE_INFO) (IN EFI_DEFERRED_IMAGE_LOAD_PROTOCOL *This, IN UINTN ImageIndex, OUT EFI_DEVICE_PATH_PROTOCOL **ImageDevicePath, OUT VOID **Image, OUT UINTN *ImageSize, OUT BOOLEAN *BootOption)

Returns information about a deferred image.

This function returns information about a single deferred image. The deferred images are numbered consecutively, starting with 0. If there is no image which corresponds to ImageIndex, then EFI_NOT_FOUND is returned. All deferred images may be returned by iteratively calling this function until EFI_NOT_FOUND is returned. Image may be NULL and ImageSize set to 0 if the decision to defer execution was made because of the location of the executable image rather than its actual contents. record handle until there are no more, at which point UserInfo will point to NULL.

Parameters
[in]ThisPoints to this instance of the EFI_DEFERRED_IMAGE_LOAD_PROTOCOL.
[in]ImageIndexZero-based index of the deferred index.
[out]ImageDevicePathOn return, points to a pointer to the device path of the image. The device path should not be freed by the caller.
[out]ImageOn return, points to the first byte of the image or NULL if the image is not available. The image should not be freed by the caller unless LoadImage() has been called successfully.
[out]ImageSizeOn return, the size of the image, or 0 if the image is not available.
[out]BootOptionOn return, points to TRUE if the image was intended as a boot option or FALSE if it was not intended as a boot option.
Return values
EFI_SUCCESSImage information returned successfully.
EFI_NOT_FOUNDImageIndex does not refer to a valid image.
EFI_INVALID_PARAMETERImageDevicePath is NULL or Image is NULL or ImageSize is NULL or BootOption is NULL.

Definition at line 55 of file DeferredImageLoad.h.

◆ EFI_DEFERRED_IMAGE_LOAD_PROTOCOL