SetupDesignGuide.pdf - Firmware Encoding Index

Setup Design Guide
DRAFT
7.1.1 EFI_HII_PROTOCOL.NewPack()
Summary
Extracts the various packs from a package list.
Prototype
EFI_STATUS
(EFIAPI *EFI_HII_NEW_PACK) (
IN EFI_HII_PROTOCOL
IN EFI_HII_PACK_LIST
OUT EFI_HII_HANDLE
);
*This,
*Package,
*Handle
Parameters
This
PackageList
Handle
A pointer to the EFI_HII_PROTOCOL instance.
A pointer to an EFI_HII_PACK_LIST package instance.
A pointer to the EFI_HII_HANDLE instance.
Description
With the exception of font and keyboard data, this function adds the contents of the package list to the
database and returns a handle back to the data. Font and keyboard data is kept in a common pool and
will have a NULL handle associated with them. In the case where a PackageList contains both
pooled data and database data, a valid handle will be returned upon the addition of the appropriate data
into the database.
Status Codes Returned
EFI_SUCCESS
EFI_INVALID_PARAMETER
Data was extracted from the Package, Database was updated with
the data, and Handle returned successfully.
The content of the Package was invalid.
52