EdkCompatibilityPkg/Foundation/Framework/Protocol/FormBrowser/FormBrowser.h

   1 /*++
   2
   3 Copyright (c) 2004, Intel Corporation
   4 All rights reserved. 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     FormBrowser.h
  15
  16 Abstract:
  17
  18   The EFI_FORM_BROWSER_PROTOCOL is the interface to the EFI
  19   Configuration Driver.  This will allow the caller to direct the
  20   configuration driver to use either the HII database or use the passed
  21   in packet of data.  This will also allow the caller to post messages
  22   into the configuration drivers internal mailbox.
  23
  24 --*/
  25
  26 #ifndef _FORM_BROWSER_H_
  27 #define _FORM_BROWSER_H_
  28
  29 #include EFI_PROTOCOL_DEFINITION (Hii)
  30
  31 #define EFI_FORM_BROWSER_PROTOCOL_GUID \
  32   { \
  33     0xe5a1333e, 0xe1b4, 0x4d55, 0xce, 0xeb, 0x35, 0xc3, 0xef, 0x13, 0x34, 0x43 \
  34   }
  35
  36 //
  37 // Forward reference for pure ANSI compatability
  38 //
  39 EFI_FORWARD_DECLARATION (EFI_FORM_BROWSER_PROTOCOL);
  40
  41 typedef struct _EFI_FORM_BROWSER_PROTOCOL EFI_FORM_BROWSER_PROTOCOL;
  42
  43 typedef struct {
  44   UINT32  Length;
  45   UINT16  Type;
  46   UINT8   Data[1];
  47 } EFI_HII_PACKET;
  48
  49 typedef struct {
  50   EFI_HII_IFR_PACK    *IfrData;
  51   EFI_HII_STRING_PACK *StringData;
  52 } EFI_IFR_PACKET;
  53
  54 typedef struct {
  55   UINTN LeftColumn;
  56   UINTN RightColumn;
  57   UINTN TopRow;
  58   UINTN BottomRow;
  59 } SCREEN_DESCRIPTOR;
  60
  61 //
  62 // The following types are currently defined:
  63 //
  64 typedef
  65 EFI_STATUS
  66 (EFIAPI *EFI_SEND_FORM) (
  67   IN  EFI_FORM_BROWSER_PROTOCOL       * This,
  68   IN  BOOLEAN                         UseDatabase,
  69   IN  EFI_HII_HANDLE                  * Handle,
  70   IN  UINTN                           HandleCount,
  71   IN  EFI_IFR_PACKET                  * Packet,
  72   IN  EFI_HANDLE                      CallbackHandle,
  73   IN  UINT8                           *NvMapOverride,
  74   IN SCREEN_DESCRIPTOR                * ScreenDimensions,
  75   OUT BOOLEAN                         *ResetRequired OPTIONAL
  76   );
  77
  78 typedef
  79 EFI_STATUS
  80 (EFIAPI *EFI_CREATE_POP_UP) (
  81   IN  UINTN                           NumberOfLines,
  82   IN  BOOLEAN                         HotKey,
  83   IN  UINTN                           MaximumStringSize,
  84   OUT CHAR16                          *StringBuffer,
  85   OUT EFI_INPUT_KEY                   * KeyValue,
  86   IN  CHAR16                          *String,
  87   ...
  88   );
  89
  90 typedef struct _EFI_FORM_BROWSER_PROTOCOL {
  91   EFI_SEND_FORM     SendForm;
  92   EFI_CREATE_POP_UP CreatePopUp;
  93 } EFI_FORM_BROWSER_PROTOCOL;
  94
  95 extern EFI_GUID gEfiFormBrowserProtocolGuid;
  96
  97 #endif