-/*++\r
+/** @file\r
+ Support functions to connect/disconnect UEFI Driver model Protocol\r
\r
-Copyright (c) 2006, Intel Corporation \r
-All rights reserved. This program and the accompanying materials \r
-are licensed and made available under the terms and conditions of the BSD License \r
-which accompanies this distribution. The full text of the license may be found at \r
-http://opensource.org/licenses/bsd-license.php \r
- \r
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
+Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>\r
+This program and the accompanying materials\r
+are licensed and made available under the terms and conditions of the BSD License\r
+which accompanies this distribution. The full text of the license may be found at\r
+http://opensource.org/licenses/bsd-license.php\r
\r
-Module Name:\r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
- DriverSupport.c\r
- \r
-Abstract:\r
+**/\r
\r
- EFI Driver Support Protocol\r
+#include "DxeMain.h"\r
+#include "Handle.h"\r
\r
-Revision History\r
-\r
---*/\r
-\r
-#include <DxeMain.h>\r
-\r
-//\r
-// Driver Support Function Prototypes\r
-//\r
-EFI_STATUS \r
-CoreConnectSingleController (\r
- IN EFI_HANDLE ControllerHandle,\r
- IN EFI_HANDLE *DriverImageHandle OPTIONAL,\r
- IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath OPTIONAL\r
- );\r
\r
//\r
// Driver Support Functions\r
//\r
-EFI_STATUS \r
+/**\r
+ Connects one or more drivers to a controller.\r
+\r
+ @param ControllerHandle The handle of the controller to which driver(s) are to be connected.\r
+ @param DriverImageHandle A pointer to an ordered list handles that support the\r
+ EFI_DRIVER_BINDING_PROTOCOL.\r
+ @param RemainingDevicePath A pointer to the device path that specifies a child of the\r
+ controller specified by ControllerHandle.\r
+ @param Recursive If TRUE, then ConnectController() is called recursively\r
+ until the entire tree of controllers below the controller specified\r
+ by ControllerHandle have been created. If FALSE, then\r
+ the tree of controllers is only expanded one level.\r
+\r
+ @retval EFI_SUCCESS 1) One or more drivers were connected to ControllerHandle.\r
+ 2) No drivers were connected to ControllerHandle, but\r
+ RemainingDevicePath is not NULL, and it is an End Device\r
+ Path Node.\r
+ @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.\r
+ @retval EFI_NOT_FOUND 1) There are no EFI_DRIVER_BINDING_PROTOCOL instances\r
+ present in the system.\r
+ 2) No drivers were connected to ControllerHandle.\r
+ @retval EFI_SECURITY_VIOLATION \r
+ The user has no permission to start UEFI device drivers on the device path \r
+ associated with the ControllerHandle or specified by the RemainingDevicePath.\r
+\r
+**/\r
+EFI_STATUS\r
EFIAPI\r
CoreConnectController (\r
IN EFI_HANDLE ControllerHandle,\r
IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath OPTIONAL,\r
IN BOOLEAN Recursive\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Connects one or more drivers to a controller.\r
-\r
-Arguments:\r
-\r
- ControllerHandle - Handle of the controller to be connected.\r
-\r
- DriverImageHandle - DriverImageHandle A pointer to an ordered list of driver image handles.\r
-\r
- RemainingDevicePath - RemainingDevicePath A pointer to the device path that specifies a child of the\r
- controller specified by ControllerHandle.\r
- \r
- Recursive - Whether the function would be called recursively or not.\r
-\r
-Returns:\r
-\r
- Status code.\r
-\r
---*/\r
{\r
EFI_STATUS Status;\r
EFI_STATUS ReturnStatus;\r
EFI_HANDLE *ChildHandleBuffer;\r
UINTN ChildHandleCount;\r
UINTN Index;\r
- \r
+ UINTN HandleFilePathSize;\r
+ UINTN RemainingDevicePathSize;\r
+ EFI_DEVICE_PATH_PROTOCOL *HandleFilePath;\r
+ EFI_DEVICE_PATH_PROTOCOL *FilePath;\r
+ EFI_DEVICE_PATH_PROTOCOL *TempFilePath;\r
+\r
//\r
// Make sure ControllerHandle is valid\r
//\r
return Status;\r
}\r
\r
+ if (gSecurity2 != NULL) {\r
+ //\r
+ // Check whether the user has permission to start UEFI device drivers.\r
+ //\r
+ Status = CoreHandleProtocol (ControllerHandle, &gEfiDevicePathProtocolGuid, (VOID **)&HandleFilePath);\r
+ if (!EFI_ERROR (Status)) {\r
+ ASSERT (HandleFilePath != NULL);\r
+ FilePath = HandleFilePath;\r
+ TempFilePath = NULL;\r
+ if (RemainingDevicePath != NULL && !Recursive) {\r
+ HandleFilePathSize = GetDevicePathSize (HandleFilePath) - sizeof (EFI_DEVICE_PATH_PROTOCOL);\r
+ RemainingDevicePathSize = GetDevicePathSize (RemainingDevicePath);\r
+ TempFilePath = AllocateZeroPool (HandleFilePathSize + RemainingDevicePathSize);\r
+ ASSERT (TempFilePath != NULL);\r
+ CopyMem (TempFilePath, HandleFilePath, HandleFilePathSize);\r
+ CopyMem ((UINT8 *) TempFilePath + HandleFilePathSize, RemainingDevicePath, RemainingDevicePathSize);\r
+ FilePath = TempFilePath;\r
+ }\r
+ Status = gSecurity2->FileAuthentication (\r
+ gSecurity2,\r
+ FilePath,\r
+ NULL,\r
+ 0,\r
+ FALSE\r
+ );\r
+ if (TempFilePath != NULL) {\r
+ FreePool (TempFilePath);\r
+ }\r
+ if (EFI_ERROR (Status)) {\r
+ return Status;\r
+ }\r
+ }\r
+ }\r
+ \r
Handle = ControllerHandle;\r
\r
//\r
//\r
AlignedRemainingDevicePath = NULL;\r
if (RemainingDevicePath != NULL) {\r
- AlignedRemainingDevicePath = CoreDuplicateDevicePath (RemainingDevicePath);\r
+ AlignedRemainingDevicePath = DuplicateDevicePath (RemainingDevicePath);\r
+\r
+ if (AlignedRemainingDevicePath == NULL) {\r
+ return EFI_OUT_OF_RESOURCES;\r
+ }\r
}\r
\r
//\r
//\r
do {\r
ReturnStatus = CoreConnectSingleController (\r
- ControllerHandle,\r
- DriverImageHandle,\r
- AlignedRemainingDevicePath\r
- );\r
+ ControllerHandle,\r
+ DriverImageHandle,\r
+ AlignedRemainingDevicePath\r
+ );\r
} while (ReturnStatus == EFI_NOT_READY);\r
\r
//\r
//\r
for (Link = Handle->Protocols.ForwardLink, ChildHandleCount = 0; Link != &Handle->Protocols; Link = Link->ForwardLink) {\r
Prot = CR(Link, PROTOCOL_INTERFACE, Link, PROTOCOL_INTERFACE_SIGNATURE);\r
- for (ProtLink = Prot->OpenList.ForwardLink; \r
- ProtLink != &Prot->OpenList; \r
+ for (ProtLink = Prot->OpenList.ForwardLink;\r
+ ProtLink != &Prot->OpenList;\r
ProtLink = ProtLink->ForwardLink) {\r
OpenData = CR (ProtLink, OPEN_PROTOCOL_DATA, Link, OPEN_PROTOCOL_DATA_SIGNATURE);\r
if ((OpenData->Attributes & EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER) != 0) {\r
//\r
// Allocate a handle buffer for ControllerHandle's children\r
//\r
- ChildHandleBuffer = CoreAllocateBootServicesPool (ChildHandleCount * sizeof(EFI_HANDLE));\r
+ ChildHandleBuffer = AllocatePool (ChildHandleCount * sizeof(EFI_HANDLE));\r
+ if (ChildHandleBuffer == NULL) {\r
+ CoreReleaseProtocolLock ();\r
+ return EFI_OUT_OF_RESOURCES;\r
+ }\r
\r
//\r
// Fill in a handle buffer with ControllerHandle's children\r
//\r
for (Link = Handle->Protocols.ForwardLink, ChildHandleCount = 0; Link != &Handle->Protocols; Link = Link->ForwardLink) {\r
Prot = CR(Link, PROTOCOL_INTERFACE, Link, PROTOCOL_INTERFACE_SIGNATURE);\r
- for (ProtLink = Prot->OpenList.ForwardLink; \r
- ProtLink != &Prot->OpenList; \r
+ for (ProtLink = Prot->OpenList.ForwardLink;\r
+ ProtLink != &Prot->OpenList;\r
ProtLink = ProtLink->ForwardLink) {\r
OpenData = CR (ProtLink, OPEN_PROTOCOL_DATA, Link, OPEN_PROTOCOL_DATA_SIGNATURE);\r
if ((OpenData->Attributes & EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER) != 0) {\r
NULL,\r
NULL,\r
TRUE\r
- ); \r
+ );\r
}\r
\r
//\r
return ReturnStatus;\r
}\r
\r
+\r
+/**\r
+ Add Driver Binding Protocols from Context Driver Image Handles to sorted\r
+ Driver Binding Protocol list.\r
+\r
+ @param DriverBindingHandle Handle of the driver binding\r
+ protocol.\r
+ @param NumberOfSortedDriverBindingProtocols Number Of sorted driver binding\r
+ protocols\r
+ @param SortedDriverBindingProtocols The sorted protocol list.\r
+ @param DriverBindingHandleCount Driver Binding Handle Count.\r
+ @param DriverBindingHandleBuffer The buffer of driver binding\r
+ protocol to be modified.\r
+ @param IsImageHandle Indicate whether\r
+ DriverBindingHandle is an image\r
+ handle\r
+\r
+ @return None.\r
+\r
+**/\r
VOID\r
AddSortedDriverBindingProtocol (\r
IN EFI_HANDLE DriverBindingHandle,\r
- IN OUT UINTN *NumberOfSortedDriverBindingProtocols, \r
+ IN OUT UINTN *NumberOfSortedDriverBindingProtocols,\r
IN OUT EFI_DRIVER_BINDING_PROTOCOL **SortedDriverBindingProtocols,\r
IN UINTN DriverBindingHandleCount,\r
IN OUT EFI_HANDLE *DriverBindingHandleBuffer,\r
IN BOOLEAN IsImageHandle\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Add Driver Binding Protocols from Context Driver Image Handles to sorted \r
- Driver Binding Protocol list.\r
-\r
-Arguments:\r
-\r
- DriverBindingHandle - Handle of the driver binding protocol.\r
-\r
- NumberOfSortedDriverBindingProtocols - Number Of sorted driver binding protocols\r
-\r
- SortedDriverBindingProtocols - The sorted protocol list. \r
- \r
- DriverBindingHandleCount - Driver Binding Handle Count.\r
-\r
- DriverBindingHandleBuffer - The buffer of driver binding protocol to be modified.\r
-\r
- IsImageHandle - Indicate whether DriverBindingHandle is an image handle\r
- \r
-Returns:\r
-\r
- None.\r
-\r
---*/\r
{\r
EFI_STATUS Status;\r
EFI_DRIVER_BINDING_PROTOCOL *DriverBinding;\r
Status = CoreHandleProtocol (\r
DriverBindingHandleBuffer[Index],\r
&gEfiDriverBindingProtocolGuid,\r
- (VOID **)&DriverBinding\r
+ (VOID **) &DriverBinding\r
);\r
if (EFI_ERROR (Status) || DriverBinding == NULL) {\r
continue;\r
if (DriverBinding->ImageHandle == DriverBindingHandle) {\r
AddSortedDriverBindingProtocol (\r
DriverBindingHandleBuffer[Index],\r
- NumberOfSortedDriverBindingProtocols, \r
+ NumberOfSortedDriverBindingProtocols,\r
SortedDriverBindingProtocols,\r
DriverBindingHandleCount,\r
DriverBindingHandleBuffer,\r
Status = CoreHandleProtocol(\r
DriverBindingHandle,\r
&gEfiDriverBindingProtocolGuid,\r
- (VOID **)&DriverBinding\r
+ (VOID **) &DriverBinding\r
);\r
//\r
// If DriverBindingHandle does not support the Driver Binding Protocol then return\r
}\r
}\r
}\r
- \r
-EFI_STATUS \r
-CoreConnectSingleController (\r
- IN EFI_HANDLE ControllerHandle,\r
- IN EFI_HANDLE *ContextDriverImageHandles OPTIONAL,\r
- IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath OPTIONAL \r
- )\r
-/*++\r
\r
-Routine Description:\r
\r
+/**\r
Connects a controller to a driver.\r
\r
-Arguments:\r
-\r
- ControllerHandle - Handle of the controller to be connected.\r
- ContextDriverImageHandles - DriverImageHandle A pointer to an ordered list of driver image handles.\r
- RemainingDevicePath - RemainingDevicePath A pointer to the device path that specifies a child \r
- of the controller specified by ControllerHandle.\r
- \r
-Returns:\r
-\r
- EFI_SUCCESS - One or more drivers were connected to ControllerHandle.\r
- EFI_OUT_OF_RESOURCES - No enough system resources to complete the request.\r
- EFI_NOT_FOUND - No drivers were connected to ControllerHandle.\r
-\r
---*/\r
+ @param ControllerHandle Handle of the controller to be\r
+ connected.\r
+ @param ContextDriverImageHandles DriverImageHandle A pointer to an\r
+ ordered list of driver image\r
+ handles.\r
+ @param RemainingDevicePath RemainingDevicePath A pointer to\r
+ the device path that specifies a\r
+ child of the controller\r
+ specified by ControllerHandle.\r
+\r
+ @retval EFI_SUCCESS One or more drivers were\r
+ connected to ControllerHandle.\r
+ @retval EFI_OUT_OF_RESOURCES No enough system resources to\r
+ complete the request.\r
+ @retval EFI_NOT_FOUND No drivers were connected to\r
+ ControllerHandle.\r
+\r
+**/\r
+EFI_STATUS\r
+CoreConnectSingleController (\r
+ IN EFI_HANDLE ControllerHandle,\r
+ IN EFI_HANDLE *ContextDriverImageHandles OPTIONAL,\r
+ IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath OPTIONAL\r
+ )\r
{\r
EFI_STATUS Status;\r
UINTN Index;\r
UINTN NewDriverBindingHandleCount;\r
EFI_HANDLE *NewDriverBindingHandleBuffer;\r
EFI_DRIVER_BINDING_PROTOCOL *DriverBinding;\r
+ EFI_DRIVER_FAMILY_OVERRIDE_PROTOCOL *DriverFamilyOverride;\r
UINTN NumberOfSortedDriverBindingProtocols;\r
EFI_DRIVER_BINDING_PROTOCOL **SortedDriverBindingProtocols;\r
+ UINT32 DriverFamilyOverrideVersion;\r
UINT32 HighestVersion;\r
UINTN HighestIndex;\r
UINTN SortIndex;\r
DriverBindingHandleBuffer = NULL;\r
NumberOfSortedDriverBindingProtocols = 0;\r
SortedDriverBindingProtocols = NULL;\r
+ PlatformDriverOverride = NULL;\r
+ NewDriverBindingHandleBuffer = NULL;\r
\r
//\r
// Get list of all Driver Binding Protocol Instances\r
//\r
Status = CoreLocateHandleBuffer (\r
- ByProtocol, \r
- &gEfiDriverBindingProtocolGuid, \r
+ ByProtocol,\r
+ &gEfiDriverBindingProtocolGuid,\r
NULL,\r
- &DriverBindingHandleCount, \r
+ &DriverBindingHandleCount,\r
&DriverBindingHandleBuffer\r
);\r
if (EFI_ERROR (Status) || (DriverBindingHandleCount == 0)) {\r
//\r
// Allocate a duplicate array for the sorted Driver Binding Protocol Instances\r
//\r
- SortedDriverBindingProtocols = CoreAllocateBootServicesPool (sizeof (VOID *) * DriverBindingHandleCount);\r
+ SortedDriverBindingProtocols = AllocatePool (sizeof (VOID *) * DriverBindingHandleCount);\r
if (SortedDriverBindingProtocols == NULL) {\r
CoreFreePool (DriverBindingHandleBuffer);\r
return EFI_OUT_OF_RESOURCES;\r
for (Index = 0; ContextDriverImageHandles[Index] != NULL; Index++) {\r
AddSortedDriverBindingProtocol (\r
ContextDriverImageHandles[Index],\r
- &NumberOfSortedDriverBindingProtocols, \r
+ &NumberOfSortedDriverBindingProtocols,\r
SortedDriverBindingProtocols,\r
DriverBindingHandleCount,\r
DriverBindingHandleBuffer,\r
// Add the Platform Driver Override Protocol drivers for ControllerHandle next\r
//\r
Status = CoreLocateProtocol (\r
- &gEfiPlatformDriverOverrideProtocolGuid, \r
- NULL, \r
- (VOID **)&PlatformDriverOverride\r
+ &gEfiPlatformDriverOverrideProtocolGuid,\r
+ NULL,\r
+ (VOID **) &PlatformDriverOverride\r
);\r
if (!EFI_ERROR (Status) && (PlatformDriverOverride != NULL)) {\r
DriverImageHandle = NULL;\r
if (!EFI_ERROR (Status)) {\r
AddSortedDriverBindingProtocol (\r
DriverImageHandle,\r
- &NumberOfSortedDriverBindingProtocols, \r
+ &NumberOfSortedDriverBindingProtocols,\r
SortedDriverBindingProtocols,\r
DriverBindingHandleCount,\r
DriverBindingHandleBuffer,\r
} while (!EFI_ERROR (Status));\r
}\r
\r
+ //\r
+ // Add the Driver Family Override Protocol drivers for ControllerHandle\r
+ //\r
+ while (TRUE) {\r
+ HighestIndex = DriverBindingHandleCount;\r
+ HighestVersion = 0;\r
+ for (Index = 0; Index < DriverBindingHandleCount; Index++) {\r
+ Status = CoreHandleProtocol (\r
+ DriverBindingHandleBuffer[Index],\r
+ &gEfiDriverFamilyOverrideProtocolGuid,\r
+ (VOID **) &DriverFamilyOverride\r
+ );\r
+ if (!EFI_ERROR (Status) && (DriverFamilyOverride != NULL)) {\r
+ DriverFamilyOverrideVersion = DriverFamilyOverride->GetVersion (DriverFamilyOverride);\r
+ if ((HighestIndex == DriverBindingHandleCount) || (DriverFamilyOverrideVersion > HighestVersion)) {\r
+ HighestVersion = DriverFamilyOverrideVersion;\r
+ HighestIndex = Index;\r
+ }\r
+ }\r
+ }\r
+\r
+ if (HighestIndex == DriverBindingHandleCount) {\r
+ break;\r
+ }\r
+\r
+ AddSortedDriverBindingProtocol (\r
+ DriverBindingHandleBuffer[HighestIndex],\r
+ &NumberOfSortedDriverBindingProtocols,\r
+ SortedDriverBindingProtocols,\r
+ DriverBindingHandleCount,\r
+ DriverBindingHandleBuffer,\r
+ FALSE\r
+ );\r
+ }\r
+\r
//\r
// Get the Bus Specific Driver Override Protocol instance on the Controller Handle\r
//\r
Status = CoreHandleProtocol (\r
- ControllerHandle, \r
- &gEfiBusSpecificDriverOverrideProtocolGuid, \r
- (VOID **)&BusSpecificDriverOverride\r
+ ControllerHandle,\r
+ &gEfiBusSpecificDriverOverrideProtocolGuid,\r
+ (VOID **) &BusSpecificDriverOverride\r
);\r
if (!EFI_ERROR (Status) && (BusSpecificDriverOverride != NULL)) {\r
DriverImageHandle = NULL;\r
if (!EFI_ERROR (Status)) {\r
AddSortedDriverBindingProtocol (\r
DriverImageHandle,\r
- &NumberOfSortedDriverBindingProtocols, \r
+ &NumberOfSortedDriverBindingProtocols,\r
SortedDriverBindingProtocols,\r
DriverBindingHandleCount,\r
DriverBindingHandleBuffer,\r
for (Index = 0; Index < DriverBindingHandleCount; Index++) {\r
AddSortedDriverBindingProtocol (\r
DriverBindingHandleBuffer[Index],\r
- &NumberOfSortedDriverBindingProtocols, \r
+ &NumberOfSortedDriverBindingProtocols,\r
SortedDriverBindingProtocols,\r
DriverBindingHandleCount,\r
DriverBindingHandleBuffer,\r
// EFI_NOT_READY, so it will be restarted\r
//\r
Status = CoreLocateHandleBuffer (\r
- ByProtocol, \r
- &gEfiDriverBindingProtocolGuid, \r
+ ByProtocol,\r
+ &gEfiDriverBindingProtocolGuid,\r
NULL,\r
- &NewDriverBindingHandleCount, \r
+ &NewDriverBindingHandleCount,\r
&NewDriverBindingHandleBuffer\r
);\r
CoreFreePool (NewDriverBindingHandleBuffer);\r
\r
//\r
// Loop through the sorted Driver Binding Protocol Instances in order, and see if\r
- // any of the Driver Binding Protocols support the controller specified by \r
+ // any of the Driver Binding Protocols support the controller specified by\r
// ControllerHandle.\r
//\r
DriverBinding = NULL;\r
for (Index = 0; (Index < NumberOfSortedDriverBindingProtocols) && !DriverFound; Index++) {\r
if (SortedDriverBindingProtocols[Index] != NULL) {\r
DriverBinding = SortedDriverBindingProtocols[Index];\r
+ PERF_START (DriverBinding->DriverBindingHandle, "DB:Support:", NULL, 0);\r
Status = DriverBinding->Supported(\r
- DriverBinding, \r
+ DriverBinding,\r
ControllerHandle,\r
RemainingDevicePath\r
);\r
+ PERF_END (DriverBinding->DriverBindingHandle, "DB:Support:", NULL, 0);\r
if (!EFI_ERROR (Status)) {\r
SortedDriverBindingProtocols[Index] = NULL;\r
DriverFound = TRUE;\r
// A driver was found that supports ControllerHandle, so attempt to start the driver\r
// on ControllerHandle.\r
//\r
- PERF_START (DriverBinding->DriverBindingHandle, DRIVERBINDING_START_TOK, NULL, 0);\r
+ PERF_START (DriverBinding->DriverBindingHandle, "DB:Start:", NULL, 0);\r
Status = DriverBinding->Start (\r
- DriverBinding, \r
+ DriverBinding,\r
ControllerHandle,\r
RemainingDevicePath\r
);\r
- PERF_END (DriverBinding->DriverBindingHandle, DRIVERBINDING_START_TOK, NULL, 0);\r
+ PERF_END (DriverBinding->DriverBindingHandle, "DB:Start:", NULL, 0);\r
\r
if (!EFI_ERROR (Status)) {\r
//\r
//\r
if (OneStarted) {\r
return EFI_SUCCESS;\r
- } \r
+ }\r
\r
//\r
// If no drivers started and RemainingDevicePath is an End Device Path Node, then return EFI_SUCCESS\r
if (IsDevicePathEnd (RemainingDevicePath)) {\r
return EFI_SUCCESS;\r
}\r
- } \r
+ }\r
\r
//\r
// Otherwise, no drivers were started on ControllerHandle, so return EFI_NOT_FOUND\r
}\r
\r
\r
-EFI_STATUS \r
+\r
+/**\r
+ Disonnects a controller from a driver\r
+\r
+ @param ControllerHandle ControllerHandle The handle of\r
+ the controller from which\r
+ driver(s) are to be\r
+ disconnected.\r
+ @param DriverImageHandle DriverImageHandle The driver to\r
+ disconnect from ControllerHandle.\r
+ @param ChildHandle ChildHandle The handle of the\r
+ child to destroy.\r
+\r
+ @retval EFI_SUCCESS One or more drivers were\r
+ disconnected from the controller.\r
+ @retval EFI_SUCCESS On entry, no drivers are managing\r
+ ControllerHandle.\r
+ @retval EFI_SUCCESS DriverImageHandle is not NULL,\r
+ and on entry DriverImageHandle is\r
+ not managing ControllerHandle.\r
+ @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.\r
+ @retval EFI_INVALID_PARAMETER DriverImageHandle is not NULL,\r
+ and it is not a valid EFI_HANDLE.\r
+ @retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it\r
+ is not a valid EFI_HANDLE.\r
+ @retval EFI_OUT_OF_RESOURCES There are not enough resources\r
+ available to disconnect any\r
+ drivers from ControllerHandle.\r
+ @retval EFI_DEVICE_ERROR The controller could not be\r
+ disconnected because of a device\r
+ error.\r
+\r
+**/\r
+EFI_STATUS\r
EFIAPI\r
CoreDisconnectController (\r
IN EFI_HANDLE ControllerHandle,\r
IN EFI_HANDLE DriverImageHandle OPTIONAL,\r
IN EFI_HANDLE ChildHandle OPTIONAL\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disonnects a controller from a driver\r
-\r
-Arguments:\r
-\r
- ControllerHandle - ControllerHandle The handle of the controller from which driver(s) \r
- are to be disconnected.\r
- DriverImageHandle - DriverImageHandle The driver to disconnect from ControllerHandle.\r
- ChildHandle - ChildHandle The handle of the child to destroy.\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - One or more drivers were disconnected from the controller.\r
- EFI_SUCCESS - On entry, no drivers are managing ControllerHandle.\r
- EFI_SUCCESS - DriverImageHandle is not NULL, and on entry DriverImageHandle is not managing ControllerHandle.\r
- EFI_INVALID_PARAMETER - ControllerHandle is not a valid EFI_HANDLE.\r
- EFI_INVALID_PARAMETER - DriverImageHandle is not NULL, and it is not a valid EFI_HANDLE.\r
- EFI_INVALID_PARAMETER - ChildHandle is not NULL, and it is not a valid EFI_HANDLE.\r
- EFI_OUT_OF_RESOURCES - There are not enough resources available to disconnect any drivers from ControllerHandle.\r
- EFI_DEVICE_ERROR - The controller could not be disconnected because of a device error.\r
-\r
---*/\r
{\r
EFI_STATUS Status;\r
IHANDLE *Handle;\r
// Get list of drivers that are currently managing ControllerHandle\r
//\r
DriverImageHandleBuffer = NULL;\r
- DriverImageHandleCount = 1; \r
- \r
+ DriverImageHandleCount = 1;\r
+\r
if (DriverImageHandle == NULL) {\r
//\r
// Look at each protocol interface for a match\r
CoreAcquireProtocolLock ();\r
for (Link = Handle->Protocols.ForwardLink; Link != &Handle->Protocols; Link = Link->ForwardLink) {\r
Prot = CR(Link, PROTOCOL_INTERFACE, Link, PROTOCOL_INTERFACE_SIGNATURE);\r
- for (ProtLink = Prot->OpenList.ForwardLink; \r
- ProtLink != &Prot->OpenList; \r
+ for (ProtLink = Prot->OpenList.ForwardLink;\r
+ ProtLink != &Prot->OpenList;\r
ProtLink = ProtLink->ForwardLink) {\r
OpenData = CR (ProtLink, OPEN_PROTOCOL_DATA, Link, OPEN_PROTOCOL_DATA_SIGNATURE);\r
if ((OpenData->Attributes & EFI_OPEN_PROTOCOL_BY_DRIVER) != 0) {\r
}\r
}\r
CoreReleaseProtocolLock ();\r
- \r
+\r
//\r
// If there are no drivers managing this controller, then return EFI_SUCCESS\r
//\r
goto Done;\r
}\r
\r
- DriverImageHandleBuffer = CoreAllocateBootServicesPool (sizeof (EFI_HANDLE) * DriverImageHandleCount);\r
+ DriverImageHandleBuffer = AllocatePool (sizeof (EFI_HANDLE) * DriverImageHandleCount);\r
if (DriverImageHandleBuffer == NULL) {\r
Status = EFI_OUT_OF_RESOURCES;\r
goto Done;\r
CoreAcquireProtocolLock ();\r
for (Link = Handle->Protocols.ForwardLink; Link != &Handle->Protocols; Link = Link->ForwardLink) {\r
Prot = CR(Link, PROTOCOL_INTERFACE, Link, PROTOCOL_INTERFACE_SIGNATURE);\r
- for (ProtLink = Prot->OpenList.ForwardLink; \r
- ProtLink != &Prot->OpenList; \r
+ for (ProtLink = Prot->OpenList.ForwardLink;\r
+ ProtLink != &Prot->OpenList;\r
ProtLink = ProtLink->ForwardLink) {\r
OpenData = CR (ProtLink, OPEN_PROTOCOL_DATA, Link, OPEN_PROTOCOL_DATA_SIGNATURE);\r
if ((OpenData->Attributes & EFI_OPEN_PROTOCOL_BY_DRIVER) != 0) {\r
// Get the Driver Binding Protocol of the driver that is managing this controller\r
//\r
Status = CoreHandleProtocol (\r
- DriverImageHandle, \r
- &gEfiDriverBindingProtocolGuid, \r
+ DriverImageHandle,\r
+ &gEfiDriverBindingProtocolGuid,\r
(VOID **)&DriverBinding\r
);\r
- if (EFI_ERROR (Status)) {\r
+ if (EFI_ERROR (Status) || DriverBinding == NULL) {\r
Status = EFI_INVALID_PARAMETER;\r
goto Done;\r
}\r
CoreAcquireProtocolLock ();\r
for (Link = Handle->Protocols.ForwardLink; Link != &Handle->Protocols; Link = Link->ForwardLink) {\r
Prot = CR(Link, PROTOCOL_INTERFACE, Link, PROTOCOL_INTERFACE_SIGNATURE);\r
- for (ProtLink = Prot->OpenList.ForwardLink; \r
- ProtLink != &Prot->OpenList; \r
+ for (ProtLink = Prot->OpenList.ForwardLink;\r
+ ProtLink != &Prot->OpenList;\r
ProtLink = ProtLink->ForwardLink) {\r
OpenData = CR (ProtLink, OPEN_PROTOCOL_DATA, Link, OPEN_PROTOCOL_DATA_SIGNATURE);\r
if (OpenData->AgentHandle == DriverImageHandle) {\r
if ((OpenData->Attributes & EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER) != 0) {\r
ChildBufferCount++;\r
- } \r
+ }\r
if ((OpenData->Attributes & EFI_OPEN_PROTOCOL_BY_DRIVER) != 0) {\r
DriverImageHandleValid = TRUE;\r
}\r
ChildHandleValid = FALSE;\r
ChildBuffer = NULL;\r
if (ChildBufferCount != 0) {\r
- ChildBuffer = CoreAllocateBootServicesPool (sizeof (EFI_HANDLE) * ChildBufferCount);\r
+ ChildBuffer = AllocatePool (sizeof (EFI_HANDLE) * ChildBufferCount);\r
if (ChildBuffer == NULL) {\r
Status = EFI_OUT_OF_RESOURCES;\r
goto Done;\r
CoreAcquireProtocolLock ();\r
for (Link = Handle->Protocols.ForwardLink; Link != &Handle->Protocols; Link = Link->ForwardLink) {\r
Prot = CR(Link, PROTOCOL_INTERFACE, Link, PROTOCOL_INTERFACE_SIGNATURE);\r
- for (ProtLink = Prot->OpenList.ForwardLink; \r
- ProtLink != &Prot->OpenList; \r
+ for (ProtLink = Prot->OpenList.ForwardLink;\r
+ ProtLink != &Prot->OpenList;\r
ProtLink = ProtLink->ForwardLink) {\r
OpenData = CR (ProtLink, OPEN_PROTOCOL_DATA, Link, OPEN_PROTOCOL_DATA_SIGNATURE);\r
if ((OpenData->AgentHandle == DriverImageHandle) &&\r
} else {\r
Status = EFI_NOT_FOUND;\r
}\r
- \r
-Done: \r
+\r
+Done:\r
\r
if (DriverImageHandleBuffer != NULL) {\r
CoreFreePool (DriverImageHandleBuffer);\r