+++ /dev/null
-/** @file\r
- This PPI opens or closes an I/O aperture in a ISA HOST controller.\r
-\r
- Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>\r
- 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
- @par Revision Reference:\r
- This PPI is from PI Version 1.2.1.\r
-\r
-**/\r
-\r
-#ifndef __ISA_HC_PPI_H__\r
-#define __ISA_HC_PPI_H__\r
-\r
-#define EFI_ISA_HC_PPI_GUID \\r
- { \\r
- 0x8d48bd70, 0xc8a3, 0x4c06, {0x90, 0x1b, 0x74, 0x79, 0x46, 0xaa, 0xc3, 0x58} \\r
- }\r
-\r
-typedef struct _EFI_ISA_HC_PPI EFI_ISA_HC_PPI;\r
-typedef struct _EFI_ISA_HC_PPI *PEFI_ISA_HC_PPI;\r
-\r
-/**\r
- Open I/O aperture.\r
-\r
- This function opens an I/O aperture in a ISA Host Controller for the I/O\r
- addresses specified by IoAddress to IoAddress + IoLength - 1. It is possible\r
- that more than one caller may be assigned to the same aperture.\r
- It may be possible that a single hardware aperture may be used for more than\r
- one device. This function tracks the number of times that each aperture is \r
- referenced, and doesa not close the hardware aperture (via CloseIoAperture())\r
- until there are no more references to it.\r
- \r
- @param This A pointer to this instance of the EFI_ISA_HC_PPI.\r
- @param IoAddress An unsigned integer that specifies the first byte of\r
- the I/O space required.\r
- @param IoLength An unsigned integer that specifies the number of\r
- bytes of the I/O space required.\r
- @param IoApertureHandle A pointer to the returned I/O aperture handle.\r
- This value can be used on subsequent calls to CloseIoAperture().\r
-\r
- @retval EFI_SUCCESS The I/O aperture was opened successfully.\r
- @retval EFI_UNSUPPORTED The ISA Host Controller is a subtractive-decode controller.\r
- @retval EFI_OUT_OF_RESOURCES There is no available I/O aperture.\r
-**/\r
-typedef\r
-EFI_STATUS\r
-(EFIAPI *EFI_PEI_ISA_HC_OPEN_IO) (\r
- IN CONST EFI_ISA_HC_PPI *This,\r
- IN UINT16 IoAddress,\r
- IN UINT16 IoLength,\r
- OUT UINT64 *IoApertureHandle\r
- );\r
-\r
-/**\r
- Close I/O aperture.\r
-\r
- This function closes a previously opened I/O aperture handle. If there are no\r
- more I/O aperture handles that refer to the hardware I/O aperture resource,\r
- then the hardware I/O aperture is closed.\r
- It may be possible that a single hardware aperture may be used for more than\r
- one device. This function tracks the number of times that each aperture is\r
- referenced, and does not close the hardware aperture (via CloseIoAperture())\r
- until there are no more references to it.\r
-\r
- @param This A pointer to this instance of the EFI_ISA_HC_PPI.\r
- @param IoApertureHandle The I/O aperture handle previously returned from a\r
- call to OpenIoAperture().\r
-\r
- @retval EFI_SUCCESS The I/O aperture was closed successfully.\r
-**/ \r
-typedef\r
-EFI_STATUS\r
-(EFIAPI *EFI_PEI_ISA_HC_CLOSE_IO) (\r
- IN CONST EFI_ISA_HC_PPI *This,\r
- IN UINT64 IoApertureHandle\r
- );\r
-\r
-///\r
-/// This PPI provides functions for opening or closing an I/O aperture.\r
-///\r
-struct _EFI_ISA_HC_PPI {\r
- ///\r
- /// An unsigned integer that specifies the version of the PPI structure.\r
- ///\r
- UINT32 Version;\r
- ///\r
- /// The address of the ISA/LPC Bridge device.\r
- /// For PCI, this is the segment, bus, device and function of the a ISA/LPC\r
- /// Bridge device.\r
- ///\r
- /// If bits 24-31 are 0, then the definition is:\r
- /// Bits 0:2 - Function\r
- /// Bits 3-7 - Device\r
- /// Bits 8:15 - Bus\r
- /// Bits 16-23 - Segment\r
- /// Bits 24-31 - Bus Type\r
- /// If bits 24-31 are 0xff, then the definition is platform-specific.\r
- ///\r
- UINT32 Address;\r
- ///\r
- /// Opens an aperture on a positive-decode ISA Host Controller.\r
- ///\r
- EFI_PEI_ISA_HC_OPEN_IO OpenIoAperture;\r
- ///\r
- /// Closes an aperture on a positive-decode ISA Host Controller.\r
- ///\r
- EFI_PEI_ISA_HC_CLOSE_IO CloseIoAperture;\r
-};\r
-\r
-extern EFI_GUID gEfiIsaHcPpiGuid;\r
-\r
-#endif \r