OldMdePkg/Include/Ppi/Stall.h

   1 /** @file
   2   This file declares Stall PPI.
   3
   4   This code abstracts the PEI core to provide Stall services.
   5
   6   Copyright (c) 2006, Intel Corporation
   7   All rights reserved. This program and the accompanying materials
   8   are licensed and made available under the terms and conditions of the BSD License
   9   which accompanies this distribution.  The full text of the license may be found at
  10   http://opensource.org/licenses/bsd-license.php
  11
  12   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  13   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  14
  15   Module Name:  Stall.h
  16
  17   @par Revision Reference:
  18   This PPI is defined in PEI CIS.
  19   Version 0.91.
  20
  21 **/
  22
  23 #ifndef __STALL_PPI_H__
  24 #define __STALL_PPI_H__
  25
  26 #define EFI_PEI_STALL_PPI_GUID \
  27   { \
  28     0x1f4c6f90, 0xb06b, 0x48d8, {0xa2, 0x01, 0xba, 0xe5, 0xf1, 0xcd, 0x7d, 0x56 } \
  29   }
  30
  31 typedef struct _EFI_PEI_STALL_PPI EFI_PEI_STALL_PPI;
  32
  33 /**
  34   The Stall() function provides a blocking stall for at least the number
  35   of microseconds stipulated in the final argument of the API.
  36
  37   @param  PeiServices    An indirect pointer to the PEI Services Table
  38                          published by the PEI Foundation.
  39   @param  This           Pointer to the local data for the interface.
  40   @param  Microseconds   Number of microseconds for which to stall.
  41
  42   @retval EFI_SUCCESS           The service provided at least the required delay.
  43
  44 **/
  45 typedef
  46 EFI_STATUS
  47 (EFIAPI *EFI_PEI_STALL) (
  48   IN EFI_PEI_SERVICES           **PeiServices,
  49   IN EFI_PEI_STALL_PPI          *This,
  50   IN UINTN                      Microseconds
  51   );
  52
  53 /**
  54   @par Ppi Description:
  55   This service provides a simple, blocking stall with platform-specific resolution.
  56
  57   @param Resolution
  58   The resolution in microseconds of the stall services.
  59
  60   @param Stall
  61   The actual stall procedure call.
  62
  63 **/
  64 struct _EFI_PEI_STALL_PPI {
  65   UINTN          Resolution;
  66   EFI_PEI_STALL  Stall;
  67 };
  68
  69 extern EFI_GUID gEfiPeiStallPpiGuid;
  70
  71 #endif