Updated headers to follow coding standard

[mirror_edk2.git] / MdePkg / Include / Protocol / BusSpecificDriverOverride.h

/** @file\r
  Bus Specific Driver Override protocol as defined in the EFI 1.1 specification.\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
\r
**/\r
\r
#ifndef _EFI_BUS_SPECIFIC_DRIVER_OVERRIDE_PROTOCOL_H_\r
#define _EFI_BUS_SPECIFIC_DRIVER_OVERRIDE_PROTOCOL_H_\r
\r
//\r
// Global ID for the Bus Specific Driver Override Protocol\r
//\r
#define EFI_BUS_SPECIFIC_DRIVER_OVERRIDE_PROTOCOL_GUID \\r
  { \\r
    0x3bc1b285, 0x8a15, 0x4a82, {0xaa, 0xbf, 0x4d, 0x7d, 0x13, 0xfb, 0x32, 0x65 } \\r
  }\r
\r
typedef struct _EFI_BUS_SPECIFIC_DRIVER_OVERRIDE_PROTOCOL  EFI_BUS_SPECIFIC_DRIVER_OVERRIDE_PROTOCOL;\r
\r
//\r
// Prototypes for the Bus Specific Driver Override Protocol\r
//\r
\r
/**                                                                   \r
  Uses a bus specific algorithm to retrieve a driver image handle for a controller.\r
    \r
  @param  This                  A pointer to the EFI_BUS_SPECIFIC_DRIVER_\r
                                OVERRIDE_PROTOCOL instance.              \r
  @param  DriverImageHandle     On input, a pointer to the previous driver image handle returned\r
                                by GetDriver(). On output, a pointer to the next driver         \r
                                image handle. Passing in a NULL, will return the first driver   \r
                                image handle.                                                     \r
                                \r
  @retval EFI_SUCCESS           A bus specific override driver is returned in DriverImageHandle.\r
  @retval EFI_NOT_FOUND         The end of the list of override drivers was reached.\r
  @retval EFI_INVALID_PARAMETER DriverImageHandle is not a handle that was returned on a\r
                                previous call to GetDriver().                           \r
                                   \r
**/   \r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_BUS_SPECIFIC_DRIVER_OVERRIDE_GET_DRIVER) (\r
  IN EFI_BUS_SPECIFIC_DRIVER_OVERRIDE_PROTOCOL              *This,\r
  IN OUT EFI_HANDLE                                         *DriverImageHandle\r
  );\r
\r
//\r
// Interface structure for the Bus Specific Driver Override Protocol\r
//\r
struct _EFI_BUS_SPECIFIC_DRIVER_OVERRIDE_PROTOCOL {\r
  EFI_BUS_SPECIFIC_DRIVER_OVERRIDE_GET_DRIVER GetDriver;\r
};\r
\r
extern EFI_GUID gEfiBusSpecificDriverOverrideProtocolGuid;\r
\r
#endif\r