--- /dev/null
+/** @file\r
+ Entry point to a EFI/DXE driver.\r
+\r
+Copyright (c) 2006, Intel Corporation<BR>\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
+\r
+**/\r
+\r
+EFI_BOOT_SERVICES *mBS;\r
+\r
+/**\r
+ This function returns the size, in bytes, \r
+ of the device path data structure specified by DevicePath.\r
+ If DevicePath is NULL, then 0 is returned.\r
+\r
+ @param DevicePath A pointer to a device path data structure.\r
+\r
+ @return The size of a device path in bytes.\r
+\r
+**/\r
+STATIC\r
+UINTN\r
+EFIAPI\r
+SmmGetDevicePathSize (\r
+ IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath\r
+ )\r
+{\r
+ CONST EFI_DEVICE_PATH_PROTOCOL *Start;\r
+\r
+ if (DevicePath == NULL) {\r
+ return 0;\r
+ }\r
+\r
+ //\r
+ // Search for the end of the device path structure\r
+ //\r
+ Start = DevicePath;\r
+ while (!EfiIsDevicePathEnd (DevicePath)) {\r
+ DevicePath = EfiNextDevicePathNode (DevicePath);\r
+ }\r
+\r
+ //\r
+ // Compute the size and add back in the size of the end device path structure\r
+ //\r
+ return ((UINTN) DevicePath - (UINTN) Start) + sizeof (EFI_DEVICE_PATH_PROTOCOL);\r
+}\r
+\r
+/**\r
+ This function appends the device path SecondDevicePath\r
+ to every device path instance in FirstDevicePath. \r
+\r
+ @param FirstDevicePath A pointer to a device path data structure.\r
+ \r
+ @param SecondDevicePath A pointer to a device path data structure.\r
+\r
+ @return A pointer to the new device path is returned.\r
+ NULL is returned if space for the new device path could not be allocated from pool.\r
+ It is up to the caller to free the memory used by FirstDevicePath and SecondDevicePath\r
+ if they are no longer needed.\r
+\r
+**/\r
+EFI_DEVICE_PATH_PROTOCOL *\r
+EFIAPI\r
+SmmAppendDevicePath (\r
+ IN CONST EFI_DEVICE_PATH_PROTOCOL *FirstDevicePath,\r
+ IN CONST EFI_DEVICE_PATH_PROTOCOL *SecondDevicePath\r
+ )\r
+{\r
+ EFI_STATUS Status;\r
+ UINTN Size;\r
+ UINTN Size1;\r
+ UINTN Size2;\r
+ EFI_DEVICE_PATH_PROTOCOL *NewDevicePath;\r
+ EFI_DEVICE_PATH_PROTOCOL *DevicePath2;\r
+\r
+ ASSERT (FirstDevicePath != NULL && SecondDevicePath != NULL);\r
+\r
+ //\r
+ // Allocate space for the combined device path. It only has one end node of\r
+ // length EFI_DEVICE_PATH_PROTOCOL\r
+ //\r
+ Size1 = SmmGetDevicePathSize (FirstDevicePath);\r
+ Size2 = SmmGetDevicePathSize (SecondDevicePath);\r
+ Size = Size1 + Size2 - sizeof (EFI_DEVICE_PATH_PROTOCOL);\r
+\r
+ Status = mBS->AllocatePool (EfiBootServicesData, Size, (VOID **) &NewDevicePath);\r
+\r
+ if (EFI_SUCCESS == Status) {\r
+ mBS->CopyMem ((VOID *) NewDevicePath, (VOID *) FirstDevicePath, Size1);\r
+ //\r
+ // Over write Src1 EndNode and do the copy\r
+ //\r
+ DevicePath2 = (EFI_DEVICE_PATH_PROTOCOL *) ((CHAR8 *) NewDevicePath + (Size1 - sizeof (EFI_DEVICE_PATH_PROTOCOL)));\r
+ mBS->CopyMem ((VOID *) DevicePath2, (VOID *) SecondDevicePath, Size2);\r
+ }\r
+\r
+ return NewDevicePath;\r
+}\r
+\r
+/**\r
+ Unload function that is registered in the LoadImage protocol. It un-installs\r
+ protocols produced and deallocates pool used by the driver. Called by the core\r
+ when unloading the driver.\r
+\r
+ @param ImageHandle ImageHandle of the unloaded driver\r
+\r
+ @return Status of the ProcessModuleUnloadList.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+_DriverUnloadHandler (\r
+ EFI_HANDLE ImageHandle\r
+ )\r
+{\r
+ EFI_STATUS Status;\r
+\r
+ //\r
+ // Call the unload handlers for all the modules\r
+ //\r
+ Status = ProcessModuleUnloadList (ImageHandle);\r
+\r
+ //\r
+ // If the driver specific unload handler does not return an error, then call all of the\r
+ // library destructors. If the unload handler returned an error, then the driver can not be\r
+ // unloaded, and the library destructors should not be called\r
+ //\r
+ if (!EFI_ERROR (Status)) {\r
+ ProcessLibraryDestructorList (ImageHandle, gST);\r
+ }\r
+\r
+ //\r
+ // Return the status from the driver specific unload handler\r
+ //\r
+ return Status;\r
+}\r
+\r
+/**\r
+ Enrty point to DXE SMM Driver.\r
+\r
+ @param ImageHandle ImageHandle of the loaded driver.\r
+ @param SystemTable Pointer to the EFI System Table.\r
+\r
+ @retval EFI_SUCCESS One or more of the drivers returned a success code.\r
+ @retval !EFI_SUCESS The return status from the last driver entry point in the list.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+_ModuleEntryPoint (\r
+ IN EFI_HANDLE ImageHandle,\r
+ IN EFI_SYSTEM_TABLE *SystemTable\r
+ )\r
+{\r
+ EFI_STATUS Status;\r
+ EFI_LOADED_IMAGE_PROTOCOL *LoadedImage;\r
+ EFI_SMM_BASE_PROTOCOL *SmmBase;\r
+ BOOLEAN InSmm;\r
+ EFI_DEVICE_PATH_PROTOCOL *CompleteFilePath;\r
+ EFI_DEVICE_PATH_PROTOCOL *ImageDevicePath;\r
+ EFI_HANDLE Handle;\r
+\r
+ //\r
+ // Cache a pointer to the Boot Services Table \r
+ //\r
+ mBS = SystemTable->BootServices;\r
+\r
+ //\r
+ // Retrieve the Loaded Image Protocol\r
+ //\r
+ Status = mBS->HandleProtocol (\r
+ ImageHandle, \r
+ &gEfiLoadedImageProtocolGuid,\r
+ (VOID*)&LoadedImage\r
+ );\r
+ ASSERT_EFI_ERROR (Status);\r
+\r
+ //\r
+ // Retrieve SMM Base Protocol\r
+ //\r
+ Status = mBS->LocateProtocol (\r
+ &gEfiSmmBaseProtocolGuid, \r
+ NULL, \r
+ (VOID **) &SmmBase\r
+ );\r
+ ASSERT_EFI_ERROR (Status);\r
+\r
+ //\r
+ // Check to see if we are already in SMM\r
+ //\r
+ SmmBase->InSmm (SmmBase, &InSmm);\r
+\r
+ //\r
+ //\r
+ //\r
+ if (!InSmm) {\r
+ //\r
+ // Retrieve the Device Path Protocol from the DeviceHandle tha this driver was loaded from\r
+ //\r
+ Status = mBS->HandleProtocol (\r
+ LoadedImage->DeviceHandle, \r
+ &gEfiDevicePathProtocolGuid,\r
+ (VOID*)&ImageDevicePath\r
+ );\r
+ ASSERT_EFI_ERROR (Status);\r
+\r
+ //\r
+ // Build the full device path to the currently execuing image\r
+ //\r
+ CompleteFilePath = SmmAppendDevicePath (ImageDevicePath, LoadedImage->FilePath);\r
+\r
+ //\r
+ // Load the image in memory to SMRAM; it will automatically generate the\r
+ // SMI.\r
+ //\r
+ Status = SmmBase->Register (SmmBase, CompleteFilePath, NULL, 0, &Handle, FALSE);\r
+ ASSERT_EFI_ERROR (Status);\r
+ return Status;\r
+ }\r
+\r
+ //\r
+ // Call constructor for all libraries\r
+ //\r
+ ProcessLibraryConstructorList (ImageHandle, SystemTable);\r
+\r
+ //\r
+ // Optionally install the unload handler\r
+ //\r
+ if (_gDriverUnloadImageCount > 0) {\r
+ Status = mBS->HandleProtocol (\r
+ ImageHandle,\r
+ &gEfiLoadedImageProtocolGuid,\r
+ (VOID **)&LoadedImage\r
+ );\r
+ ASSERT_EFI_ERROR (Status);\r
+ LoadedImage->Unload = _DriverUnloadHandler;\r
+ }\r
+\r
+ //\r
+ // Call the list of driver entry points\r
+ //\r
+ Status = ProcessModuleEntryPointList (ImageHandle, SystemTable);\r
+ if (EFI_ERROR (Status)) {\r
+ ProcessLibraryDestructorList (ImageHandle, SystemTable);\r
+ }\r
+\r
+ return Status;\r
+}\r
+\r
+/**\r
+ Enrty point wrapper of DXE SMM Driver.\r
+\r
+ @param ImageHandle ImageHandle of the loaded driver.\r
+ @param SystemTable Pointer to the EFI System Table.\r
+\r
+ @retval EFI_SUCCESS One or more of the drivers returned a success code.\r
+ @retval !EFI_SUCESS The return status from the last driver entry point in the list.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+EfiMain (\r
+ IN EFI_HANDLE ImageHandle,\r
+ IN EFI_SYSTEM_TABLE *SystemTable\r
+ )\r
+{\r
+ return _ModuleEntryPoint (ImageHandle, SystemTable);\r
+}\r
projects / mirror_edk2.git / blobdiff