NetworkPkg/HttpUtilitiesDxe/HttpUtilitiesDxe.c

   1 /** @file
   2   The DriverEntryPoint and Unload for HttpUtilities driver.
   3
   4   Copyright (c) 2015 - 2018, Intel Corporation. All rights reserved.<BR>
   5
   6   This program and the accompanying materials
   7   are licensed and made available under the terms and conditions of the BSD License
   8   which accompanies this distribution.  The full text of the license may be found at
   9   http://opensource.org/licenses/bsd-license.php.
  10
  11   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  12   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  13
  14 **/
  15
  16 #include "HttpUtilitiesDxe.h"
  17
  18
  19 /**
  20   Unloads an image.
  21
  22   @param  ImageHandle           Handle that identifies the image to be unloaded.
  23
  24   @retval EFI_SUCCESS           The image has been unloaded.
  25   @retval EFI_INVALID_PARAMETER ImageHandle is not a valid image handle.
  26
  27 **/
  28 EFI_STATUS
  29 EFIAPI
  30 HttpUtilitiesDxeUnload (
  31   IN EFI_HANDLE  ImageHandle
  32   )
  33 {
  34   EFI_STATUS                      Status;
  35   UINTN                           HandleNum;
  36   EFI_HANDLE                      *HandleBuffer;
  37   UINT32                          Index;
  38   EFI_HTTP_UTILITIES_PROTOCOL     *HttpUtilitiesProtocol;
  39
  40
  41   HandleBuffer   = NULL;
  42
  43   //
  44   // Locate all the handles with HttpUtilities protocol.
  45   //
  46   Status = gBS->LocateHandleBuffer (
  47                   ByProtocol,
  48                   &gEfiHttpUtilitiesProtocolGuid,
  49                   NULL,
  50                   &HandleNum,
  51                   &HandleBuffer
  52                   );
  53   if (EFI_ERROR (Status)) {
  54     return Status;
  55   }
  56
  57   for (Index = 0; Index < HandleNum; Index++) {
  58     //
  59     // Firstly, find HttpUtilitiesProtocol interface
  60     //
  61     Status = gBS->OpenProtocol (
  62                     HandleBuffer[Index],
  63                     &gEfiHttpUtilitiesProtocolGuid,
  64                     (VOID **) &HttpUtilitiesProtocol,
  65                     ImageHandle,
  66                     NULL,
  67                     EFI_OPEN_PROTOCOL_BY_HANDLE_PROTOCOL
  68                     );
  69     if (EFI_ERROR (Status)) {
  70       return Status;
  71     }
  72
  73     //
  74     // Then, uninstall HttpUtilities interface
  75     //
  76     Status = gBS->UninstallMultipleProtocolInterfaces (
  77                     HandleBuffer[Index],
  78                     &gEfiHttpUtilitiesProtocolGuid, HttpUtilitiesProtocol,
  79                     NULL
  80                     );
  81     if (EFI_ERROR (Status)) {
  82       return Status;
  83     }
  84   }
  85
  86   return EFI_SUCCESS;
  87 }
  88
  89
  90 /**
  91   This is the declaration of an EFI image entry point. This entry point is
  92   the same for UEFI Applications, UEFI OS Loaders, and UEFI Drivers including
  93   both device drivers and bus drivers.
  94
  95   @param  ImageHandle           The firmware allocated handle for the UEFI image.
  96   @param  SystemTable           A pointer to the EFI System Table.
  97
  98   @retval EFI_SUCCESS           The operation completed successfully.
  99   @retval Others                An unexpected error occurred.
 100 **/
 101 EFI_STATUS
 102 EFIAPI
 103 HttpUtilitiesDxeDriverEntryPoint (
 104   IN EFI_HANDLE        ImageHandle,
 105   IN EFI_SYSTEM_TABLE  *SystemTable
 106   )
 107 {
 108   EFI_STATUS             Status;
 109
 110   EFI_HANDLE             Handle;
 111
 112   Handle = NULL;
 113
 114   //
 115   // Install the HttpUtilities Protocol onto Handle
 116   //
 117   Status = gBS->InstallMultipleProtocolInterfaces (
 118                   &Handle,
 119                   &gEfiHttpUtilitiesProtocolGuid,
 120                   &mHttpUtilitiesProtocol,
 121                   NULL
 122                   );
 123
 124   return Status;
 125 }
 126