Home | History | Annotate | Download | only in AuthenticationInfo
      1 /*++
      2 
      3 Copyright (c) 2008 - 2011, Intel Corporation. All rights reserved.<BR>
      4 This program and the accompanying materials
      5 are licensed and made available under the terms and conditions of the BSD License
      6 which accompanies this distribution.  The full text of the license may be found at
      7 http://opensource.org/licenses/bsd-license.php
      8 
      9 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
     10 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
     11 
     12 Module Name:
     13 
     14     PlatformToDriverConfiguration.h
     15 
     16 Abstract:
     17 
     18     UEFI Authentication Info Protocol.
     19 
     20 Revision History:
     21 
     22 --*/
     23 
     24 #ifndef _EFI_AUTHENTICATION_INFO_H_
     25 #define _EFI_AUTHENTICATION_INFO_H_
     26 
     27 //
     28 // Global ID for the Authentication Info Protocol
     29 //
     30 #define EFI_AUTHENTICATION_INFO_PROTOCOL_GUID \
     31   { \
     32     0x7671d9d0, 0x53db, 0x4173, {0xaa, 0x69, 0x23, 0x27, 0xf2, 0x1f, 0x0b, 0xc7} \
     33   }
     34 
     35 EFI_FORWARD_DECLARATION (EFI_AUTHENTICATION_INFO_PROTOCOL);
     36 
     37 typedef
     38 EFI_STATUS
     39 (EFIAPI *EFI_AUTHENTICATION_INFO_PROTOCOL_GET) (
     40   IN  EFI_AUTHENTICATION_INFO_PROTOCOL    *This,
     41   IN  EFI_HANDLE                          ControllerHandle,
     42   OUT VOID                                **Buffer
     43   );
     44 /*++
     45 
     46   Routine Description:
     47     Retrieves the Authentication information associated with a particular
     48     controller handle.
     49 
     50   Arguments:
     51     This               - Pointer to the EFI_AUTHENTICATION_INFO_PROTOCOL instance.
     52     ControllerHandle   - Handle to the Controller.
     53     Buffer             - Pointer to the authentication information. This function
     54                          is responsible for allocating the buffer and it is the
     55                          caller's responsibility to free buffer when the caller
     56                          is finished with buffer.
     57 
     58   Returns:
     59     EFI_SUCCESS        - Successfully retrieved Authentication information
     60                          for the given ControllerHandle.
     61     EFI_NOT_FOUND      - No matching Authentication information found for the
     62                          given ControllerHandle.
     63     EFI_DEVICE_ERROR   - The Authentication information could not be retrieved
     64                          due to a hardware error.
     65 
     66 --*/
     67 
     68 typedef
     69 EFI_STATUS
     70 (EFIAPI *EFI_AUTHENTICATION_INFO_PROTOCOL_SET) (
     71   IN  EFI_AUTHENTICATION_INFO_PROTOCOL    *This,
     72   IN  EFI_HANDLE                          ControllerHandle,
     73   IN  VOID                                *Buffer
     74   );
     75 /*++
     76 
     77   Routine Description:
     78     Set the Authentication information for a given controller handle.
     79 
     80   Arguments:
     81     This               - Pointer to the EFI_AUTHENTICATION_INFO_PROTOCOL instance.
     82     ControllerHandle   - Handle to the Controller.
     83     Buffer             - Pointer to the authentication information.
     84 
     85   Returns:
     86     EFI_SUCCESS          - Successfully set the Authentication node information
     87                            for the given ControllerHandle.
     88     EFI_UNSUPPORTED      - If the platform policies do not allow setting of the
     89                            Authentication information.
     90     EFI_DEVICE_ERROR     - The authentication node information could not be configured
     91                            due to a hardware error.
     92     EFI_OUT_OF_RESOURCES - Not enough storage is available to hold the data.
     93 
     94 --*/
     95 
     96 //
     97 // Interface structure for the Authentication Info Protocol
     98 //
     99 struct _EFI_AUTHENTICATION_INFO_PROTOCOL {
    100   EFI_AUTHENTICATION_INFO_PROTOCOL_GET   Get;
    101   EFI_AUTHENTICATION_INFO_PROTOCOL_SET   Set;
    102 };
    103 
    104 extern EFI_GUID gEfiAuthenticationInfoProtocolGuid;
    105 
    106 #endif
    107