diff options
| author | qhuang8 <qhuang8@6f19259b-4bc3-4df7-8a09-765794883524> | 2007-09-17 03:39:25 +0000 |
|---|---|---|
| committer | qhuang8 <qhuang8@6f19259b-4bc3-4df7-8a09-765794883524> | 2007-09-17 03:39:25 +0000 |
| commit | f662c19489cda7f5246ea0a522cc7660a66ae4d5 (patch) | |
| tree | 7240a24d743c22b006470fb9b13177b77e2be5e0 /MdePkg/Include/Library/UefiLib.h | |
| parent | 90374bc8fd39344aed1da064e7774edaeb650bea (diff) | |
| download | edk2-platforms-f662c19489cda7f5246ea0a522cc7660a66ae4d5.tar.xz | |
1. Add EfiLibInstallDriverBindingComponentName2() to install DriverBinding Protocol and optional ComponentName Protocol and ComponentName2 Protocol. This new API should cover most cases in our UEFI drivers.
2. Refine the function headers for this driver model APIs
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@3862 6f19259b-4bc3-4df7-8a09-765794883524
Diffstat (limited to 'MdePkg/Include/Library/UefiLib.h')
| -rw-r--r-- | MdePkg/Include/Library/UefiLib.h | 155 |
1 files changed, 82 insertions, 73 deletions
diff --git a/MdePkg/Include/Library/UefiLib.h b/MdePkg/Include/Library/UefiLib.h index 874ad1f8c9..f097949629 100644 --- a/MdePkg/Include/Library/UefiLib.h +++ b/MdePkg/Include/Library/UefiLib.h @@ -854,20 +854,20 @@ AsciiErrorPrint ( );
/**
- Intialize a driver by installing the Driver Binding Protocol onto the
- driver's DriverBindingHandle. This is typically the same as the driver's
- ImageHandle, but it can be different if the driver produces multiple
- DriverBinding Protocols. This function also initializes the EFI Driver
- Library that initializes the global variables gST, gBS, gRT.
+ Intialize a driver by installing the Driver Binding Protocol onto the driver's
+ DriverBindingHandle. This is typically the same as the driver's ImageHandle, but
+ it can be different if the driver produces multiple DriverBinding Protocols.
+ If the Drvier Binding Protocol interface is NULL, then ASSERT ().
+ If the installation fails, then ASSERT ().
- @param ImageHandle The image handle of the driver
- @param SystemTable The EFI System Table that was passed to the driver's entry point
- @param DriverBinding A Driver Binding Protocol instance that this driver is producing
- @param DriverBindingHandle The handle that DriverBinding is to be installe onto. If this
- parameter is NULL, then a new handle is created.
+ @param ImageHandle The image handle of the driver.
+ @param SystemTable The EFI System Table that was passed to the driver's entry point.
+ @param DriverBinding A Driver Binding Protocol instance that this driver is producing.
+ @param DriverBindingHandle The handle that DriverBinding is to be installe onto. If this
+ parameter is NULL, then a new handle is created.
- @retval EFI_SUCCESS DriverBinding is installed onto DriverBindingHandle
- @retval Other Status from gBS->InstallProtocolInterface()
+ @retval EFI_SUCCESS The protocol installation is completed successfully.
+ @retval Others Status from gBS->InstallMultipleProtocolInterfaces().
**/
EFI_STATUS
@@ -879,24 +879,26 @@ EfiLibInstallDriverBinding ( IN EFI_HANDLE DriverBindingHandle
);
-/**
- Intialize a driver by installing the Driver Binding Protocol onto the
- driver's DriverBindingHandle. This is typically the same as the driver's
- ImageHandle, but it can be different if the driver produces multiple
- DriverBinding Protocols. This function also initializes the EFI Driver
- Library that initializes the global variables gST, gBS, gRT.
-
- @ImageHandle The image handle of the driver
- @SystemTable The EFI System Table that was passed to the driver's entry point
- @DriverBinding A Driver Binding Protocol instance that this driver is producing
- @DriverBindingHandle The handle that DriverBinding is to be installe onto. If this
- parameter is NULL, then a new handle is created.
- @ComponentName A Component Name Protocol instance that this driver is producing
- @DriverConfiguration A Driver Configuration Protocol instance that this driver is producing
- @DriverDiagnostics A Driver Diagnostics Protocol instance that this driver is producing
- @retval EFI_SUCCESS DriverBinding is installed onto DriverBindingHandle
- @retval Other Status from gBS->InstallProtocolInterface()
+/**
+ Intialize a driver by installing the Driver Binding Protocol together with the optional Component Name,
+ Driver Configure and Driver Diagnostic Protocols onto the driver's DriverBindingHandle. This is
+ typically the same as the driver's ImageHandle, but it can be different if the driver produces multiple
+ DriverBinding Protocols.
+ If the Drvier Binding Protocol interface is NULL, then ASSERT ().
+ If the installation fails, then ASSERT ().
+
+ @param ImageHandle The image handle of the driver.
+ @param SystemTable The EFI System Table that was passed to the driver's entry point.
+ @param DriverBinding A Driver Binding Protocol instance that this driver is producing.
+ @param DriverBindingHandle The handle that DriverBinding is to be installe onto. If this
+ parameter is NULL, then a new handle is created.
+ @param ComponentName A Component Name Protocol instance that this driver is producing.
+ @param DriverConfiguration A Driver Configuration Protocol instance that this driver is producing.
+ @param DriverDiagnostics A Driver Diagnostics Protocol instance that this driver is producing.
+
+ @retval EFI_SUCCESS The protocol installation is completed successfully.
+ @retval Others Status from gBS->InstallMultipleProtocolInterfaces().
**/
EFI_STATUS
@@ -912,51 +914,59 @@ EfiLibInstallAllDriverProtocols ( );
+
/**
- Intialize a driver by installing the Driver Binding Protocol
- onto the driver's DriverBindingHandle. This is typically the
- same as the driver's ImageHandle, but it can be different if
- the driver produces multiple DriverBinding Protocols. This
- function also initializes the EFI Driver Library that
- initializes the global variables gST, gBS, gRT.
-
- @ImageHandle The image handle of the driver
-
- @SystemTable The EFI System Table that was
- passed to the driver's entry
- point
-
- @DriverBinding A Driver Binding Protocol
- instance that this driver is
- producing
-
- @DriverBindingHandle The handle that DriverBinding is
- to be installe onto. If this
- parameter is NULL, then a new
- handle is created.
-
- @ComponentName A Component Name Protocol
- instance that this driver is
- producing
-
- @ComponentName2 A Component Name 2 Protocol
- instance that this driver is
- producing
-
- @DriverConfiguration A Driver Configuration Protocol
- instance that this driver is
- producing
-
- @DriverDiagnostics A Driver Diagnostics Protocol
- instance that this driver is
- producing
-
- @DriverDiagnostics2 A Driver Diagnostics 2 Protocol
- instance that this driver is
- producing
+ Intialize a driver by installing the Driver Binding Protocol together with the optional Component Name,
+ Component Name 2 onto the driver's DriverBindingHandle. This is typically the same as the driver's
+ ImageHandle, but it can be different if the driver produces multiple DriverBinding Protocols.
+ If the Drvier Binding Protocol interface is NULL, then ASSERT ().
+ If the installation fails, then ASSERT ().
+
+ @param ImageHandle The image handle of the driver.
+ @param SystemTable The EFI System Table that was passed to the driver's entry point.
+ @param DriverBinding A Driver Binding Protocol instance that this driver is producing.
+ @param DriverBindingHandle The handle that DriverBinding is to be installe onto. If this
+ parameter is NULL, then a new handle is created.
+ @param ComponentName A Component Name Protocol instance that this driver is producing.
+ @param ComponentName2 A Component Name 2 Protocol instance that this driver is producing.
- @retval EFI_SUCCESS DriverBinding is installed onto DriverBindingHandle
- @retval Other Status from gBS->InstallProtocolInterface()
+ @retval EFI_SUCCESS The protocol installation is completed successfully.
+ @retval Others Status from gBS->InstallMultipleProtocolInterfaces().
+
+**/
+EFI_STATUS
+EFIAPI
+EfiLibInstallDriverBindingComponentName2 (
+ IN CONST EFI_HANDLE ImageHandle,
+ IN CONST EFI_SYSTEM_TABLE *SystemTable,
+ IN EFI_DRIVER_BINDING_PROTOCOL *DriverBinding,
+ IN EFI_HANDLE DriverBindingHandle,
+ IN CONST EFI_COMPONENT_NAME_PROTOCOL *ComponentName, OPTIONAL
+ IN CONST EFI_COMPONENT_NAME2_PROTOCOL *ComponentName2 OPTIONAL
+ );
+
+
+/**
+ Intialize a driver by installing the Driver Binding Protocol together with the optional Component Name,
+ Component Name 2, Driver Configure, Driver Diagnostic and Driver Diagnostic 2 Protocols onto the driver's
+ DriverBindingHandle. This is typically the same as the driver's ImageHandle, but it can be different if
+ the driver produces multiple DriverBinding Protocols.
+ If the Drvier Binding Protocol interface is NULL, then ASSERT ().
+ If the installation fails, then ASSERT ().
+
+ @param ImageHandle The image handle of the driver.
+ @param SystemTable The EFI System Table that was passed to the driver's entry point.
+ @param DriverBinding A Driver Binding Protocol instance that this driver is producing.
+ @param DriverBindingHandle The handle that DriverBinding is to be installe onto. If this
+ parameter is NULL, then a new handle is created.
+ @param ComponentName A Component Name Protocol instance that this driver is producing.
+ @param ComponentName2 A Component Name 2 Protocol instance that this driver is producing.
+ @param DriverConfiguration A Driver Configuration Protocol instance that this driver is producing.
+ @param DriverDiagnostics A Driver Diagnostics Protocol instance that this driver is producing.
+ @param DriverDiagnostics2 A Driver Diagnostics Protocol 2 instance that this driver is producing.
+
+ @retval EFI_SUCCESS The protocol installation is completed successfully.
+ @retval Others Status from gBS->InstallMultipleProtocolInterfaces().
**/
EFI_STATUS
@@ -973,5 +983,4 @@ EfiLibInstallAllDriverProtocols2 ( IN CONST EFI_DRIVER_DIAGNOSTICS2_PROTOCOL *DriverDiagnostics2 OPTIONAL
);
-
#endif
|