3 Copyright (c) 2006 - 2007, Intel Corporation. All rights reserved.<BR>
4 This program and the accompanying materials
5 are licensed and made available under the terms and conditions of the BSD License
6 which accompanies this distribution. The full text of the license may be found at
7 http://opensource.org/licenses/bsd-license.php
9 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
10 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
18 Image data extraction support for common use.
23 #include "EfiDriverLib.h"
24 #include "EfiImageFormat.h"
26 #include EFI_PROTOCOL_CONSUMER (LoadedImage)
30 #if (PI_SPECIFICATION_VERSION < 0x00010000)
31 IN EFI_FIRMWARE_VOLUME_PROTOCOL
*Fv
,
33 IN EFI_FIRMWARE_VOLUME2_PROTOCOL
*Fv
,
35 IN EFI_GUID
*NameGuid
,
36 IN EFI_SECTION_TYPE SectionType
,
42 EFI_FV_FILETYPE FileType
;
43 EFI_FV_FILE_ATTRIBUTES Attributes
;
44 UINT32 AuthenticationStatus
;
47 // Read desired section content in NameGuid file
51 Status
= Fv
->ReadSection (
61 if (EFI_ERROR (Status
) && (SectionType
== EFI_SECTION_TE
)) {
63 // Try reading PE32 section, since the TE section does not exist
67 Status
= Fv
->ReadSection (
78 if (EFI_ERROR (Status
) &&
79 ((SectionType
== EFI_SECTION_TE
) || (SectionType
== EFI_SECTION_PE32
))) {
81 // Try reading raw file, since the desired section does not exist
85 Status
= Fv
->ReadFile (
101 IN EFI_GUID
*NameGuid
,
102 IN EFI_SECTION_TYPE SectionType
,
107 return GetImageEx (NULL
, NameGuid
, SectionType
, Buffer
, Size
, FALSE
);
112 IN EFI_HANDLE ImageHandle
,
113 IN EFI_GUID
*NameGuid
,
114 IN EFI_SECTION_TYPE SectionType
,
117 BOOLEAN WithinImageFv
121 EFI_HANDLE
*HandleBuffer
;
124 EFI_LOADED_IMAGE_PROTOCOL
*LoadedImage
;
125 #if (PI_SPECIFICATION_VERSION < 0x00010000)
126 EFI_FIRMWARE_VOLUME_PROTOCOL
*ImageFv
;
127 EFI_FIRMWARE_VOLUME_PROTOCOL
*Fv
;
129 EFI_FIRMWARE_VOLUME2_PROTOCOL
*ImageFv
;
130 EFI_FIRMWARE_VOLUME2_PROTOCOL
*Fv
;
133 if (ImageHandle
== NULL
&& WithinImageFv
) {
134 return EFI_INVALID_PARAMETER
;
137 Status
= EFI_NOT_FOUND
;
139 if (ImageHandle
!= NULL
) {
140 Status
= gBS
->HandleProtocol (
142 &gEfiLoadedImageProtocolGuid
,
143 (VOID
**) &LoadedImage
145 if (EFI_ERROR (Status
)) {
148 Status
= gBS
->HandleProtocol (
149 LoadedImage
->DeviceHandle
,
150 #if (PI_SPECIFICATION_VERSION < 0x00010000)
151 &gEfiFirmwareVolumeProtocolGuid
,
153 &gEfiFirmwareVolume2ProtocolGuid
,
157 if (!EFI_ERROR (Status
)) {
158 Status
= GetImageFromFv (ImageFv
, NameGuid
, SectionType
, Buffer
, Size
);
162 if (Status
== EFI_SUCCESS
|| WithinImageFv
) {
166 Status
= gBS
->LocateHandleBuffer (
168 #if (PI_SPECIFICATION_VERSION < 0x00010000)
169 &gEfiFirmwareVolumeProtocolGuid
,
171 &gEfiFirmwareVolume2ProtocolGuid
,
177 if (EFI_ERROR (Status
)) {
182 // Find desired image in all Fvs
184 for (Index
= 0; Index
< HandleCount
; ++Index
) {
185 Status
= gBS
->HandleProtocol (
187 #if (PI_SPECIFICATION_VERSION < 0x00010000)
188 &gEfiFirmwareVolumeProtocolGuid
,
190 &gEfiFirmwareVolume2ProtocolGuid
,
195 if (EFI_ERROR (Status
)) {
196 gBS
->FreePool(HandleBuffer
);
200 if (ImageFv
!= NULL
&& Fv
== ImageFv
) {
204 Status
= GetImageFromFv (Fv
, NameGuid
, SectionType
, Buffer
, Size
);
206 if (!EFI_ERROR (Status
)) {
210 gBS
->FreePool(HandleBuffer
);
215 if (Index
== HandleCount
) {
216 return EFI_NOT_FOUND
;