]>
Commit | Line | Data |
---|---|---|
2832b228 | 1 | /** @file\r |
2 | UEFI 2.2 Deferred Image Load Protocol definition.\r | |
3 | \r | |
4 | This protocol returns information about images whose load was denied because of security \r | |
5 | considerations. This information can be used by the Boot Manager or another agent to reevaluate the \r | |
6 | images when the current security profile has been changed, such as when the current user profile \r | |
7 | changes. There can be more than one instance of this protocol installed.\r | |
8 | \r | |
9 | Copyright (c) 2009, Intel Corporation \r | |
10 | All rights reserved. This program and the accompanying materials \r | |
11 | are licensed and made available under the terms and conditions of the BSD License \r | |
12 | which accompanies this distribution. The full text of the license may be found at \r | |
13 | http://opensource.org/licenses/bsd-license.php \r | |
14 | \r | |
15 | THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r | |
16 | WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r | |
17 | \r | |
18 | **/\r | |
19 | \r | |
20 | #ifndef __DEFERRED_IMAGE_LOAD_H__\r | |
21 | #define __DEFERRED_IMAGE_LOAD_H__\r | |
22 | \r | |
23 | ///\r | |
24 | /// Global ID for the Deferred Image Load Protocol\r | |
25 | ///\r | |
26 | #define EFI_DEFERRED_IMAGE_LOAD_PROTOCOL_GUID \\r | |
27 | { \\r | |
28 | 0x15853d7c, 0x3ddf, 0x43e0, { 0xa1, 0xcb, 0xeb, 0xf8, 0x5b, 0x8f, 0x87, 0x2c } \\r | |
29 | };\r | |
30 | \r | |
31 | typedef struct _EFI_DEFERRED_IMAGE_LOAD_PROTOCOL EFI_DEFERRED_IMAGE_LOAD_PROTOCOL;\r | |
32 | \r | |
33 | /**\r | |
34 | Returns information about a deferred image.\r | |
35 | \r | |
36 | This function returns information about a single deferred image. The deferred images are numbered \r | |
37 | consecutively, starting with 0. If there is no image which corresponds to ImageIndex, then \r | |
38 | EFI_NOT_FOUND is returned. All deferred images may be returned by iteratively calling this \r | |
39 | function until EFI_NOT_FOUND is returned.\r | |
40 | Image may be NULL and ImageSize set to 0 if the decision to defer execution was made because \r | |
41 | of the location of the executable image rather than its actual contents. record handle until\r | |
42 | there are no more, at which point UserInfo will point to NULL. \r | |
43 | \r | |
44 | @param[in] This Points to this instance of the EFI_DEFERRED_IMAGE_LOAD_PROTOCOL.\r | |
45 | @param[in] ImageIndex Zero-based index of the deferred index.\r | |
46 | @param[out] ImageDevicePath On return, points to a pointer to the device path of the image. The device path should \r | |
47 | not be freed by the caller. \r | |
48 | @param[out] Image On return, points to the first byte of the image or NULL if the image is not available. \r | |
49 | The image should not be freed by the caller unless LoadImage() has been called \r | |
50 | successfully. \r | |
51 | @param[out] ImageSize On return, the size of the image, or 0 if the image is not available.\r | |
52 | @param[out] BootOption On return, points to TRUE if the image was intended as a boot option or FALSE if it \r | |
53 | was not intended as a boot option. \r | |
54 | \r | |
55 | @retval EFI_SUCCESS Image information returned successfully.\r | |
56 | @retval EFI_NOT_FOUND ImageIndex does not refer to a valid image.\r | |
57 | **/\r | |
58 | typedef\r | |
59 | EFI_STATUS\r | |
60 | (EFIAPI *EFI_DEFERRED_IMAGE_INFO)(\r | |
61 | IN EFI_DEFERRED_IMAGE_LOAD_PROTOCOL *This,\r | |
62 | IN UINTN ImageIndex,\r | |
63 | OUT EFI_DEVICE_PATH_PROTOCOL **ImageDevicePath,\r | |
64 | OUT VOID **Image,\r | |
65 | OUT UINTN *ImageSize,\r | |
66 | OUT BOOLEAN *BootOption\r | |
67 | );\r | |
68 | \r | |
69 | ///\r | |
70 | /// This protocol returns information about a deferred image.\r | |
71 | ///\r | |
72 | struct _EFI_DEFERRED_IMAGE_LOAD_PROTOCOL {\r | |
73 | EFI_DEFERRED_IMAGE_INFO GetImageInfo;\r | |
74 | };\r | |
75 | \r | |
76 | extern EFI_GUID gEfiDeferredImageLoadProtocolGuid;\r | |
77 | \r | |
78 | #endif\r |