2 MDE UEFI library functions and macros
4 Copyright (c) 2006 - 2007, Intel Corporation
5 All rights reserved. This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
15 #ifndef __UEFI_LIB_H__
16 #define __UEFI_LIB_H__
18 #include <Protocol/DriverBinding.h>
19 #include <Protocol/DriverConfiguration.h>
20 #include <Protocol/ComponentName.h>
21 #include <Protocol/ComponentName2.h>
22 #include <Protocol/DriverDiagnostics.h>
23 #include <Protocol/DriverDiagnostics2.h>
26 /// Unicode String Table
30 CHAR16
*UnicodeString
;
31 } EFI_UNICODE_STRING_TABLE
;
37 EfiLockUninitialized
= 0,
53 This function searches the list of configuration tables stored in the EFI System
54 Table for a table with a GUID that matches TableGuid. If a match is found,
55 then a pointer to the configuration table is returned in Table, and EFI_SUCCESS
56 is returned. If a matching GUID is not found, then EFI_NOT_FOUND is returned.
58 @param TableGuid Pointer to table's GUID type..
59 @param Table Pointer to the table associated with TableGuid in the EFI System Table.
61 @retval EFI_SUCCESS A configuration table matching TableGuid was found.
62 @retval EFI_NOT_FOUND A configuration table matching TableGuid could not be found.
67 EfiGetSystemConfigurationTable (
68 IN EFI_GUID
*TableGuid
,
73 This function causes the notification function to be executed for every protocol
74 of type ProtocolGuid instance that exists in the system when this function is
75 invoked. In addition, every time a protocol of type ProtocolGuid instance is
76 installed or reinstalled, the notification function is also executed.
78 @param ProtocolGuid Supplies GUID of the protocol upon whose installation the event is fired.
79 @param NotifyTpl Supplies the task priority level of the event notifications.
80 @param NotifyFunction Supplies the function to notify when the event is signaled.
81 @param NotifyContext The context parameter to pass to NotifyFunction.
82 @param Registration A pointer to a memory location to receive the registration value.
84 @return The notification event that was created.
89 EfiCreateProtocolNotifyEvent(
90 IN EFI_GUID
*ProtocolGuid
,
92 IN EFI_EVENT_NOTIFY NotifyFunction
,
93 IN VOID
*NotifyContext
, OPTIONAL
94 OUT VOID
**Registration
98 This function creates an event using NotifyTpl, NoifyFunction, and NotifyContext.
99 This event is signaled with EfiNamedEventSignal(). This provide the ability for
100 one or more listeners on the same event named by the GUID specified by Name.
102 @param Name Supplies GUID name of the event.
103 @param NotifyTpl Supplies the task priority level of the event notifications.
104 @param NotifyFunction Supplies the function to notify when the event is signaled.
105 @param NotifyContext The context parameter to pass to NotifyFunction.
106 @param Registration A pointer to a memory location to receive the registration value.
108 @retval EFI_SUCCESS A named event was created.
109 @retval EFI_OUT_OF_RESOURCES There are not enough resource to create the named event.
114 EfiNamedEventListen (
115 IN CONST EFI_GUID
*Name
,
116 IN EFI_TPL NotifyTpl
,
117 IN EFI_EVENT_NOTIFY NotifyFunction
,
118 IN CONST VOID
*NotifyContext
, OPTIONAL
119 OUT VOID
*Registration OPTIONAL
123 This function signals the named event specified by Name. The named event must
124 have been created with EfiNamedEventListen().
126 @param Name Supplies GUID name of the event.
128 @retval EFI_SUCCESS A named event was signaled.
129 @retval EFI_OUT_OF_RESOURCES There are not enough resource to signal the named event.
134 EfiNamedEventSignal (
135 IN CONST EFI_GUID
*Name
139 Returns the current TPL.
141 This function returns the current TPL. There is no EFI service to directly
142 retrieve the current TPL. Instead, the RaiseTPL() function is used to raise
143 the TPL to TPL_HIGH_LEVEL. This will return the current TPL. The TPL level
144 can then immediately be restored back to the current TPL level with a call
147 @return The current TPL.
157 This function initializes a basic mutual exclusion lock to the released state
158 and returns the lock. Each lock provides mutual exclusion access at its task
159 priority level. Since there is no preemption or multiprocessor support in EFI,
160 acquiring the lock only consists of raising to the locks TPL.
162 @param Lock A pointer to the lock data structure to initialize.
163 @param Priority EFI TPL associated with the lock.
171 IN OUT EFI_LOCK
*Lock
,
176 This macro initializes the contents of a basic mutual exclusion lock to the
177 released state. Each lock provides mutual exclusion access at its task
178 priority level. Since there is no preemption or multiprocessor support in EFI,
179 acquiring the lock only consists of raising to the locks TPL.
181 @param Priority The task priority level of the lock.
186 #define EFI_INITIALIZE_LOCK_VARIABLE(Priority) \
187 {Priority, TPL_APPLICATION, EfiLockReleased }
192 Macro that calls DebugAssert() if an EFI_LOCK structure is not in the locked state.
194 If the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of PcdDebugProperyMask is set,
195 then this macro evaluates the EFI_LOCK structure specified by Lock. If Lock
196 is not in the locked state, then DebugAssert() is called passing in the source
197 filename, source line number, and Lock.
199 If Lock is NULL, then ASSERT().
201 @param LockParameter A pointer to the lock to acquire.
204 #define ASSERT_LOCKED(LockParameter) \
206 if (DebugAssertEnabled ()) { \
207 ASSERT (LockParameter != NULL); \
208 if ((LockParameter)->Lock != EfiLockAcquired) { \
209 _ASSERT (LockParameter not locked); \
216 This function raises the system's current task priority level to the task
217 priority level of the mutual exclusion lock. Then, it places the lock in the
220 @param Lock A pointer to the lock to acquire.
230 This function raises the system's current task priority level to the task
231 priority level of the mutual exclusion lock. Then, it attempts to place the
232 lock in the acquired state.
234 @param Lock A pointer to the lock to acquire.
236 @retval EFI_SUCCESS The lock was acquired.
237 @retval EFI_ACCESS_DENIED The lock could not be acquired because it is already owned.
242 EfiAcquireLockOrFail (
247 This function transitions a mutual exclusion lock from the acquired state to
248 the released state, and restores the system's task priority level to its
251 @param Lock A pointer to the lock to release.
261 Tests whether a controller handle is being managed by a specific driver.
263 This function tests whether the driver specified by DriverBindingHandle is
264 currently managing the controller specified by ControllerHandle. This test
265 is performed by evaluating if the the protocol specified by ProtocolGuid is
266 present on ControllerHandle and is was opened by DriverBindingHandle with an
267 attribute of EFI_OPEN_PROTOCOL_BY_DRIVER.
268 If ProtocolGuid is NULL, then ASSERT().
270 @param ControllerHandle A handle for a controller to test.
271 @param DriverBindingHandle Specifies the driver binding handle for the
273 @param ProtocolGuid Specifies the protocol that the driver specified
274 by DriverBindingHandle opens in its Start()
277 @retval EFI_SUCCESS ControllerHandle is managed by the driver
278 specifed by DriverBindingHandle.
279 @retval EFI_UNSUPPORTED ControllerHandle is not managed by the driver
280 specifed by DriverBindingHandle.
285 EfiTestManagedDevice (
286 IN CONST EFI_HANDLE ControllerHandle
,
287 IN CONST EFI_HANDLE DriverBindingHandle
,
288 IN CONST EFI_GUID
*ProtocolGuid
292 Tests whether a child handle is a child device of the controller.
294 This function tests whether ChildHandle is one of the children of
295 ControllerHandle. This test is performed by checking to see if the protocol
296 specified by ProtocolGuid is present on ControllerHandle and opened by
297 ChildHandle with an attribute of EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER.
298 If ProtocolGuid is NULL, then ASSERT().
300 @param ControllerHandle A handle for a (parent) controller to test.
301 @param ChildHandle A child handle to test.
302 @param ProtocolGuid Supplies the protocol that the child controller
303 opens on its parent controller.
305 @retval EFI_SUCCESS ChildHandle is a child of the ControllerHandle.
306 @retval EFI_UNSUPPORTED ChildHandle is not a child of the
313 IN CONST EFI_HANDLE ControllerHandle
,
314 IN CONST EFI_HANDLE ChildHandle
,
315 IN CONST EFI_GUID
*ProtocolGuid
319 This function looks up a Unicode string in UnicodeStringTable. If Language is
320 a member of SupportedLanguages and a Unicode string is found in UnicodeStringTable
321 that matches the language code specified by Language, then it is returned in
324 @param Language A pointer to the ISO 639-2 language code for the
325 Unicode string to look up and return.
326 @param SupportedLanguages A pointer to the set of ISO 639-2 language codes
327 that the Unicode string table supports. Language
328 must be a member of this set.
329 @param UnicodeStringTable A pointer to the table of Unicode strings.
330 @param UnicodeString A pointer to the Unicode string from UnicodeStringTable
331 that matches the language specified by Language.
333 @retval EFI_SUCCESS The Unicode string that matches the language
334 specified by Language was found
335 in the table of Unicoide strings UnicodeStringTable,
336 and it was returned in UnicodeString.
337 @retval EFI_INVALID_PARAMETER Language is NULL.
338 @retval EFI_INVALID_PARAMETER UnicodeString is NULL.
339 @retval EFI_UNSUPPORTED SupportedLanguages is NULL.
340 @retval EFI_UNSUPPORTED UnicodeStringTable is NULL.
341 @retval EFI_UNSUPPORTED The language specified by Language is not a
342 member of SupportedLanguages.
343 @retval EFI_UNSUPPORTED The language specified by Language is not
344 supported by UnicodeStringTable.
349 LookupUnicodeString (
350 IN CONST CHAR8
*Language
,
351 IN CONST CHAR8
*SupportedLanguages
,
352 IN CONST EFI_UNICODE_STRING_TABLE
*UnicodeStringTable
,
353 OUT CHAR16
**UnicodeString
357 This function looks up a Unicode string in UnicodeStringTable.
358 If Language is a member of SupportedLanguages and a Unicode
359 string is found in UnicodeStringTable that matches the
360 language code specified by Language, then it is returned in
363 @param Language A pointer to the ISO 639-2 or
364 RFC 3066 language code for the
365 Unicode string to look up and
368 @param SupportedLanguages A pointer to the set of ISO
369 639-2 or RFC 3066 language
370 codes that the Unicode string
371 table supports. Language must
372 be a member of this set.
374 @param UnicodeStringTable A pointer to the table of
377 @param UnicodeString A pointer to the Unicode
378 string from UnicodeStringTable
379 that matches the language
380 specified by Language.
382 @param Iso639Language Specify the language code
383 format supported. If true,
384 then the format follow ISO
385 639-2. If false, then it
388 @retval EFI_SUCCESS The Unicode string that
389 matches the language specified
390 by Language was found in the
391 table of Unicoide strings
392 UnicodeStringTable, and it was
393 returned in UnicodeString.
395 @retval EFI_INVALID_PARAMETER Language is NULL.
397 @retval EFI_INVALID_PARAMETER UnicodeString is NULL.
399 @retval EFI_UNSUPPORTED SupportedLanguages is NULL.
401 @retval EFI_UNSUPPORTED UnicodeStringTable is NULL.
403 @retval EFI_UNSUPPORTED The language specified by
404 Language is not a member
405 ofSupportedLanguages.
407 @retval EFI_UNSUPPORTED The language specified by
408 Language is not supported by
414 LookupUnicodeString2 (
415 IN CONST CHAR8
*Language
,
416 IN CONST CHAR8
*SupportedLanguages
,
417 IN CONST EFI_UNICODE_STRING_TABLE
*UnicodeStringTable
,
418 OUT CHAR16
**UnicodeString
,
419 IN BOOLEAN Iso639Language
423 This function adds a Unicode string to UnicodeStringTable.
424 If Language is a member of SupportedLanguages then UnicodeString is added to
425 UnicodeStringTable. New buffers are allocated for both Language and
426 UnicodeString. The contents of Language and UnicodeString are copied into
427 these new buffers. These buffers are automatically freed when
428 FreeUnicodeStringTable() is called.
430 @param Language A pointer to the ISO 639-2 language code for the Unicode
432 @param SupportedLanguages A pointer to the set of ISO 639-2 language codes
433 that the Unicode string table supports.
434 Language must be a member of this set.
435 @param UnicodeStringTable A pointer to the table of Unicode strings.
436 @param UnicodeString A pointer to the Unicode string to add.
438 @retval EFI_SUCCESS The Unicode string that matches the language
439 specified by Language was found in the table of
440 Unicode strings UnicodeStringTable, and it was
441 returned in UnicodeString.
442 @retval EFI_INVALID_PARAMETER Language is NULL.
443 @retval EFI_INVALID_PARAMETER UnicodeString is NULL.
444 @retval EFI_INVALID_PARAMETER UnicodeString is an empty string.
445 @retval EFI_UNSUPPORTED SupportedLanguages is NULL.
446 @retval EFI_ALREADY_STARTED A Unicode string with language Language is
447 already present in UnicodeStringTable.
448 @retval EFI_OUT_OF_RESOURCES There is not enough memory to add another
449 Unicode string to UnicodeStringTable.
450 @retval EFI_UNSUPPORTED The language specified by Language is not a
451 member of SupportedLanguages.
457 IN CONST CHAR8
*Language
,
458 IN CONST CHAR8
*SupportedLanguages
,
459 IN EFI_UNICODE_STRING_TABLE
**UnicodeStringTable
,
460 IN CONST CHAR16
*UnicodeString
465 This function adds a Unicode string to UnicodeStringTable.
466 If Language is a member of SupportedLanguages then
467 UnicodeString is added to UnicodeStringTable. New buffers are
468 allocated for both Language and UnicodeString. The contents
469 of Language and UnicodeString are copied into these new
470 buffers. These buffers are automatically freed when
471 FreeUnicodeStringTable() is called.
473 @param Language A pointer to the ISO 639-2 or
474 RFC 3066 language code for the
475 Unicode string to add.
477 @param SupportedLanguages A pointer to the set of ISO
478 639-2 or RFC 3066 language
479 codes that the Unicode string
480 table supports. Language must
481 be a member of this set.
483 @param UnicodeStringTable A pointer to the table of
486 @param UnicodeString A pointer to the Unicode
489 @param Iso639Language Specify the language code
490 format supported. If true,
491 then the format follow ISO
492 639-2. If false, then it
495 @retval EFI_SUCCESS The Unicode string that
496 matches the language specified
497 by Language was found in the
498 table of Unicode strings
499 UnicodeStringTable, and it was
500 returned in UnicodeString.
502 @retval EFI_INVALID_PARAMETER Language is NULL.
504 @retval EFI_INVALID_PARAMETER UnicodeString is NULL.
506 @retval EFI_INVALID_PARAMETER UnicodeString is an empty string.
508 @retval EFI_UNSUPPORTED SupportedLanguages is NULL.
510 @retval EFI_ALREADY_STARTED A Unicode string with language
511 Language is already present in
514 @retval EFI_OUT_OF_RESOURCES There is not enough memory to
515 add another Unicode string to
518 @retval EFI_UNSUPPORTED The language specified by
519 Language is not a member of
526 IN CONST CHAR8
*Language
,
527 IN CONST CHAR8
*SupportedLanguages
,
528 IN EFI_UNICODE_STRING_TABLE
**UnicodeStringTable
,
529 IN CONST CHAR16
*UnicodeString
,
530 IN BOOLEAN Iso639Language
534 This function frees the table of Unicode strings in UnicodeStringTable.
535 If UnicodeStringTable is NULL, then EFI_SUCCESS is returned.
536 Otherwise, each language code, and each Unicode string in the Unicode string
537 table are freed, and EFI_SUCCESS is returned.
539 @param UnicodeStringTable A pointer to the table of Unicode strings.
541 @retval EFI_SUCCESS The Unicode string table was freed.
546 FreeUnicodeStringTable (
547 IN EFI_UNICODE_STRING_TABLE
*UnicodeStringTable
551 This function computes and returns the width of the Unicode character
552 specified by UnicodeChar.
554 @param UnicodeChar A Unicode character.
556 @retval 0 The width if UnicodeChar could not be determined.
557 @retval 1 UnicodeChar is a narrow glyph.
558 @retval 2 UnicodeChar is a wide glyph.
564 IN CHAR16 UnicodeChar
568 This function computes and returns the display length of
569 the Null-terminated Unicode string specified by String.
570 If String is NULL, then 0 is returned.
571 If any of the widths of the Unicode characters in String
572 can not be determined, then 0 is returned.
574 @param String A pointer to a Null-terminated Unicode string.
576 @return The display length of the Null-terminated Unicode string specified by String.
581 UnicodeStringDisplayLength (
582 IN CONST CHAR16
*String
586 // Functions that abstract early Framework contamination of UEFI.
589 Signal a Ready to Boot Event.
591 Create a Ready to Boot Event. Signal it and close it. This causes other
592 events of the same event group to be signaled in other modules.
597 EfiSignalEventReadyToBoot (
602 Signal a Legacy Boot Event.
604 Create a legacy Boot Event. Signal it and close it. This causes other
605 events of the same event group to be signaled in other modules.
610 EfiSignalEventLegacyBoot (
615 Create a Legacy Boot Event.
617 Tiano extended the CreateEvent Type enum to add a legacy boot event type.
618 This was bad as Tiano did not own the enum. In UEFI 2.0 CreateEventEx was
619 added and now it's possible to not voilate the UEFI specification by
620 declaring a GUID for the legacy boot event class. This library supports
621 the EDK/EFI 1.10 form and EDK II/UEFI 2.0 form and allows common code to
624 @param LegacyBootEvent Returns the EFI event returned from gBS->CreateEvent(Ex).
626 @retval EFI_SUCCESS Event was created.
627 @retval Other Event was not created.
632 EfiCreateEventLegacyBoot (
633 OUT EFI_EVENT
*LegacyBootEvent
637 Create an EFI event in the Legacy Boot Event Group and allows
638 the caller to specify a notification function.
640 This function abstracts the creation of the Legacy Boot Event.
641 The Framework moved from a proprietary to UEFI 2.0 based mechanism.
642 This library abstracts the caller from how this event is created to prevent
643 to code form having to change with the version of the specification supported.
644 If LegacyBootEvent is NULL, then ASSERT().
646 @param NotifyTpl The task priority level of the event.
647 @param NotifyFunction The notification function to call when the event is signaled.
648 @param NotifyContext The content to pass to NotifyFunction when the event is signaled.
649 @param LegacyBootEvent Returns the EFI event returned from gBS->CreateEvent(Ex).
651 @retval EFI_SUCCESS Event was created.
652 @retval Other Event was not created.
657 EfiCreateEventLegacyBootEx (
658 IN EFI_TPL NotifyTpl
,
659 IN EFI_EVENT_NOTIFY NotifyFunction
, OPTIONAL
660 IN VOID
*NotifyContext
, OPTIONAL
661 OUT EFI_EVENT
*LegacyBootEvent
665 Create a Read to Boot Event.
667 Tiano extended the CreateEvent Type enum to add a ready to boot event type.
668 This was bad as Tiano did not own the enum. In UEFI 2.0 CreateEventEx was
669 added and now it's possible to not voilate the UEFI specification and use
670 the ready to boot event class defined in UEFI 2.0. This library supports
671 the EDK/EFI 1.10 form and EDKII/UEFI 2.0 form and allows common code to
674 @param ReadyToBootEvent Returns the EFI event returned from gBS->CreateEvent(Ex).
676 @retval EFI_SUCCESS Event was created.
677 @retval Other Event was not created.
682 EfiCreateEventReadyToBoot (
683 OUT EFI_EVENT
*ReadyToBootEvent
687 Create an EFI event in the Ready To Boot Event Group and allows
688 the caller to specify a notification function.
690 This function abstracts the creation of the Ready to Boot Event.
691 The Framework moved from a proprietary to UEFI 2.0 based mechanism.
692 This library abstracts the caller from how this event is created to prevent
693 to code form having to change with the version of the specification supported.
694 If ReadyToBootEvent is NULL, then ASSERT().
696 @param NotifyTpl The task priority level of the event.
697 @param NotifyFunction The notification function to call when the event is signaled.
698 @param NotifyContext The content to pass to NotifyFunction when the event is signaled.
699 @param ReadyToBootEvent Returns the EFI event returned from gBS->CreateEvent(Ex).
701 @retval EFI_SUCCESS Event was created.
702 @retval Other Event was not created.
707 EfiCreateEventReadyToBootEx (
708 IN EFI_TPL NotifyTpl
,
709 IN EFI_EVENT_NOTIFY NotifyFunction
, OPTIONAL
710 IN VOID
*NotifyContext
, OPTIONAL
711 OUT EFI_EVENT
*ReadyToBootEvent
715 Initialize a Firmware Volume (FV) Media Device Path node.
717 Tiano extended the EFI 1.10 device path nodes. Tiano does not own this enum
718 so as we move to UEFI 2.0 support we must use a mechanism that conforms with
719 the UEFI 2.0 specification to define the FV device path. An UEFI GUIDed
720 device path is defined for Tiano extensions of device path. If the code
721 is compiled to conform with the UEFI 2.0 specification use the new device path
722 else use the old form for backwards compatability.
724 @param FvDevicePathNode Pointer to a FV device path node to initialize
725 @param NameGuid FV file name to use in FvDevicePathNode
730 EfiInitializeFwVolDevicepathNode (
731 IN OUT MEDIA_FW_VOL_FILEPATH_DEVICE_PATH
*FvDevicePathNode
,
732 IN CONST EFI_GUID
*NameGuid
736 Check to see if the Firmware Volume (FV) Media Device Path is valid
738 Tiano extended the EFI 1.10 device path nodes. Tiano does not own this enum
739 so as we move to UEFI 2.0 support we must use a mechanism that conforms with
740 the UEFI 2.0 specification to define the FV device path. An UEFI GUIDed
741 device path is defined for Tiano extensions of device path. If the code
742 is compiled to conform with the UEFI 2.0 specification use the new device path
743 else use the old form for backwards compatability. The return value to this
744 function points to a location in FvDevicePathNode and it does not allocate
745 new memory for the GUID pointer that is returned.
747 @param FvDevicePathNode Pointer to FV device path to check.
749 @retval NULL FvDevicePathNode is not valid.
750 @retval Other FvDevicePathNode is valid and pointer to NameGuid was returned.
755 EfiGetNameGuidFromFwVolDevicePathNode (
756 IN CONST MEDIA_FW_VOL_FILEPATH_DEVICE_PATH
*FvDevicePathNode
760 Prints a formatted Unicode string to the console output device specified by
761 ConOut defined in the EFI_SYSTEM_TABLE.
763 This function prints a formatted Unicode string to the console output device
764 specified by ConOut in EFI_SYSTEM_TABLE and returns the number of Unicode
765 characters that printed to ConOut. If the length of the formatted Unicode
766 string is greater than PcdUefiLibMaxPrintBufferSize, then only the first
767 PcdUefiLibMaxPrintBufferSize characters are sent to ConOut.
769 @param Format Null-terminated Unicode format string.
770 @param ... VARARG list consumed to process Format.
771 If Format is NULL, then ASSERT().
772 If Format is not aligned on a 16-bit boundary, then ASSERT().
774 @return Number of Unicode characters printed to ConOut.
780 IN CONST CHAR16
*Format
,
785 Prints a formatted Unicode string to the console output device specified by
786 StdErr defined in the EFI_SYSTEM_TABLE.
788 This function prints a formatted Unicode string to the console output device
789 specified by StdErr in EFI_SYSTEM_TABLE and returns the number of Unicode
790 characters that printed to StdErr. If the length of the formatted Unicode
791 string is greater than PcdUefiLibMaxPrintBufferSize, then only the first
792 PcdUefiLibMaxPrintBufferSize characters are sent to StdErr.
794 @param Format Null-terminated Unicode format string.
795 @param ... VARARG list consumed to process Format.
796 If Format is NULL, then ASSERT().
797 If Format is not aligned on a 16-bit boundary, then ASSERT().
799 @return Number of Unicode characters printed to StdErr.
805 IN CONST CHAR16
*Format
,
810 Prints a formatted ASCII string to the console output device specified by
811 ConOut defined in the EFI_SYSTEM_TABLE.
813 This function prints a formatted ASCII string to the console output device
814 specified by ConOut in EFI_SYSTEM_TABLE and returns the number of ASCII
815 characters that printed to ConOut. If the length of the formatted ASCII
816 string is greater than PcdUefiLibMaxPrintBufferSize, then only the first
817 PcdUefiLibMaxPrintBufferSize characters are sent to ConOut.
819 @param Format Null-terminated ASCII format string.
820 @param ... VARARG list consumed to process Format.
821 If Format is NULL, then ASSERT().
822 If Format is not aligned on a 16-bit boundary, then ASSERT().
824 @return Number of ASCII characters printed to ConOut.
830 IN CONST CHAR8
*Format
,
835 Prints a formatted ASCII string to the console output device specified by
836 StdErr defined in the EFI_SYSTEM_TABLE.
838 This function prints a formatted ASCII string to the console output device
839 specified by StdErr in EFI_SYSTEM_TABLE and returns the number of ASCII
840 characters that printed to StdErr. If the length of the formatted ASCII
841 string is greater than PcdUefiLibMaxPrintBufferSize, then only the first
842 PcdUefiLibMaxPrintBufferSize characters are sent to StdErr.
844 @param Format Null-terminated ASCII format string.
845 @param ... VARARG list consumed to process Format.
846 If Format is NULL, then ASSERT().
847 If Format is not aligned on a 16-bit boundary, then ASSERT().
849 @return Number of ASCII characters printed to ConErr.
855 IN CONST CHAR8
*Format
,
860 Initializes a driver by installing the Driver Binding Protocol onto the driver's
861 DriverBindingHandle. This is typically the same as the driver's ImageHandle, but
862 it can be different if the driver produces multiple DriverBinding Protocols.
863 If the Driver Binding Protocol interface is NULL, then ASSERT ().
864 If the installation fails, then ASSERT ().
866 @param ImageHandle The image handle of the driver.
867 @param SystemTable The EFI System Table that was passed to the driver's entry point.
868 @param DriverBinding A Driver Binding Protocol instance that this driver is producing.
869 @param DriverBindingHandle The handle that DriverBinding is to be installed onto. If this
870 parameter is NULL, then a new handle is created.
872 @retval EFI_SUCCESS The protocol installation is completed successfully.
873 @retval Others Status from gBS->InstallMultipleProtocolInterfaces().
878 EfiLibInstallDriverBinding (
879 IN CONST EFI_HANDLE ImageHandle
,
880 IN CONST EFI_SYSTEM_TABLE
*SystemTable
,
881 IN EFI_DRIVER_BINDING_PROTOCOL
*DriverBinding
,
882 IN EFI_HANDLE DriverBindingHandle
887 Initializes a driver by installing the Driver Binding Protocol together with the optional Component Name,
888 Driver Configure and Driver Diagnostic Protocols onto the driver's DriverBindingHandle. This is
889 typically the same as the driver's ImageHandle, but it can be different if the driver produces multiple
890 DriverBinding Protocols.
891 If the Driver Binding Protocol interface is NULL, then ASSERT ().
892 If the installation fails, then ASSERT ().
894 @param ImageHandle The image handle of the driver.
895 @param SystemTable The EFI System Table that was passed to the driver's entry point.
896 @param DriverBinding A Driver Binding Protocol instance that this driver is producing.
897 @param DriverBindingHandle The handle that DriverBinding is to be installed onto. If this
898 parameter is NULL, then a new handle is created.
899 @param ComponentName A Component Name Protocol instance that this driver is producing.
900 @param DriverConfiguration A Driver Configuration Protocol instance that this driver is producing.
901 @param DriverDiagnostics A Driver Diagnostics Protocol instance that this driver is producing.
903 @retval EFI_SUCCESS The protocol installation is completed successfully.
904 @retval Others Status from gBS->InstallMultipleProtocolInterfaces().
909 EfiLibInstallAllDriverProtocols (
910 IN CONST EFI_HANDLE ImageHandle
,
911 IN CONST EFI_SYSTEM_TABLE
*SystemTable
,
912 IN EFI_DRIVER_BINDING_PROTOCOL
*DriverBinding
,
913 IN EFI_HANDLE DriverBindingHandle
,
914 IN CONST EFI_COMPONENT_NAME_PROTOCOL
*ComponentName
, OPTIONAL
915 IN CONST EFI_DRIVER_CONFIGURATION_PROTOCOL
*DriverConfiguration
, OPTIONAL
916 IN CONST EFI_DRIVER_DIAGNOSTICS_PROTOCOL
*DriverDiagnostics OPTIONAL
922 Initializes a driver by installing the Driver Binding Protocol together with the optional Component Name,
923 Component Name 2 onto the driver's DriverBindingHandle. This is typically the same as the driver's
924 ImageHandle, but it can be different if the driver produces multiple DriverBinding Protocols.
925 If the Driver Binding Protocol interface is NULL, then ASSERT ().
926 If the installation fails, then ASSERT ().
928 @param ImageHandle The image handle of the driver.
929 @param SystemTable The EFI System Table that was passed to the driver's entry point.
930 @param DriverBinding A Driver Binding Protocol instance that this driver is producing.
931 @param DriverBindingHandle The handle that DriverBinding is to be installed onto. If this
932 parameter is NULL, then a new handle is created.
933 @param ComponentName A Component Name Protocol instance that this driver is producing.
934 @param ComponentName2 A Component Name 2 Protocol instance that this driver is producing.
936 @retval EFI_SUCCESS The protocol installation is completed successfully.
937 @retval Others Status from gBS->InstallMultipleProtocolInterfaces().
942 EfiLibInstallDriverBindingComponentName2 (
943 IN CONST EFI_HANDLE ImageHandle
,
944 IN CONST EFI_SYSTEM_TABLE
*SystemTable
,
945 IN EFI_DRIVER_BINDING_PROTOCOL
*DriverBinding
,
946 IN EFI_HANDLE DriverBindingHandle
,
947 IN CONST EFI_COMPONENT_NAME_PROTOCOL
*ComponentName
, OPTIONAL
948 IN CONST EFI_COMPONENT_NAME2_PROTOCOL
*ComponentName2 OPTIONAL
953 Initializes a driver by installing the Driver Binding Protocol together with the optional Component Name,
954 Component Name 2, Driver Configure, Driver Diagnostic and Driver Diagnostic 2 Protocols onto the driver's
955 DriverBindingHandle. This is typically the same as the driver's ImageHandle, but it can be different if
956 the driver produces multiple DriverBinding Protocols.
957 If the Driver Binding Protocol interface is NULL, then ASSERT ().
958 If the installation fails, then ASSERT ().
960 @param ImageHandle The image handle of the driver.
961 @param SystemTable The EFI System Table that was passed to the driver's entry point.
962 @param DriverBinding A Driver Binding Protocol instance that this driver is producing.
963 @param DriverBindingHandle The handle that DriverBinding is to be installed onto. If this
964 parameter is NULL, then a new handle is created.
965 @param ComponentName A Component Name Protocol instance that this driver is producing.
966 @param ComponentName2 A Component Name 2 Protocol instance that this driver is producing.
967 @param DriverConfiguration A Driver Configuration Protocol instance that this driver is producing.
968 @param DriverDiagnostics A Driver Diagnostics Protocol instance that this driver is producing.
969 @param DriverDiagnostics2 A Driver Diagnostics Protocol 2 instance that this driver is producing.
971 @retval EFI_SUCCESS The protocol installation is completed successfully.
972 @retval Others Status from gBS->InstallMultipleProtocolInterfaces().
977 EfiLibInstallAllDriverProtocols2 (
978 IN CONST EFI_HANDLE ImageHandle
,
979 IN CONST EFI_SYSTEM_TABLE
*SystemTable
,
980 IN EFI_DRIVER_BINDING_PROTOCOL
*DriverBinding
,
981 IN EFI_HANDLE DriverBindingHandle
,
982 IN CONST EFI_COMPONENT_NAME_PROTOCOL
*ComponentName
, OPTIONAL
983 IN CONST EFI_COMPONENT_NAME2_PROTOCOL
*ComponentName2
, OPTIONAL
984 IN CONST EFI_DRIVER_CONFIGURATION_PROTOCOL
*DriverConfiguration
, OPTIONAL
985 IN CONST EFI_DRIVER_DIAGNOSTICS_PROTOCOL
*DriverDiagnostics
, OPTIONAL
986 IN CONST EFI_DRIVER_DIAGNOSTICS2_PROTOCOL
*DriverDiagnostics2 OPTIONAL