updated parameters name to match spec.

[mirror_edk2.git] / IntelFrameworkPkg / Include / Protocol / IncompatiblePciDeviceSupport.h

diff --git a/IntelFrameworkPkg/Include/Protocol/IncompatiblePciDeviceSupport.h b/IntelFrameworkPkg/Include/Protocol/IncompatiblePciDeviceSupport.h
index 0c45fb7c2741646cda096374531f2ee4159e94cc..a763399395fbd73a127cfc4b83f635ab62a108cc 100644 (file)
--- a/IntelFrameworkPkg/Include/Protocol/IncompatiblePciDeviceSupport.h
+++ b/IntelFrameworkPkg/Include/Protocol/IncompatiblePciDeviceSupport.h
@@ -1,7 +1,21 @@
 /** @file\r
   This file declares EFI Incompatible PCI Device Support Protocol\r
-\r
-  Copyright (c) 2007, Intel Corporation\r
+  This protocol allows the PCI bus driver to support resource allocation for some PCI devices that do not comply\r
+  with the PCI Specification.\r
+  The EFI_INCOMPATIBLE_PCI_DEVICE_SUPPORT_PROTOCOL is used by the PCI bus driver\r
+  to support resource allocation for some PCI devices that do not comply with the PCI Specification.\r
+  This protocol can find some incompatible PCI devices and report their special resource\r
+  requirements to the PCI bus driver. The generic PCI bus driver does not have prior knowledge of\r
+  any incompatible PCI devices. It interfaces with the\r
+  EFI_INCOMPATIBLE_PCI_DEVICE_SUPPORT_PROTOCOL to find out if a device is\r
+  incompatible and to obtain the special configuration requirements for a specific incompatible PCI\r
+  device.\r
+  This protocol is optional, and only one instance of this protocol can be present in the system. If a\r
+  platform supports this protocol, this protocol is produced by a Driver Execution Environment\r
+  (DXE) driver and must be made available before the Boot Device Selection (BDS) phase. The PCI\r
+  bus driver will look for the presence of this protocol before it begins PCI enumeration.\r
+\r
+  Copyright (c) 2007 - 2009, 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
@@ -10,18 +24,15 @@
   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
-  Module Name:  IncompatiblePciDeviceSupport.h\r
-\r
   @par Revision Reference:\r
   This protocol is defined in Framework of EFI PCI Platform Support Specification.\r
-  Version0.9\r
+  Version 0.9.\r
 \r
 **/\r
 \r
 #ifndef _INCOMPATIBLE_PCI_DEVICE_SUPPORT_H_\r
 #define _INCOMPATIBLE_PCI_DEVICE_SUPPORT_H_\r
 \r
-#include <PiDxe.h>\r
 \r
 #define EFI_INCOMPATIBLE_PCI_DEVICE_SUPPORT_PROTOCOL_GUID \\r
         {0xeb23f55a, 0x7863, 0x4ac2, {0x8d, 0x3d, 0x95, 0x65, 0x35, 0xde, 0x03, 0x75} }\r
@@ -33,9 +44,9 @@ typedef struct _EFI_INCOMPATIBLE_PCI_DEVICE_SUPPORT_PROTOCOL EFI_INCOMPATIBLE_PC
   resource configuration requirements for an incompatible PCI device.\r
 \r
   @param  This                  Pointer to the EFI_INCOMPATIBLE_PCI_DEVICE_SUPPORT_PROTOCOL instance.\r
-  @param  VendorID              A unique ID to identify the manufacturer of the PCI device.\r
-  @param  DeviceID              A unique ID to identify the particular PCI device.\r
-  @param  RevisionID            A PCI device-specific revision identifier.\r
+  @param  VendorId              A unique ID to identify the manufacturer of the PCI device.\r
+  @param  DeviceId              A unique ID to identify the particular PCI device.\r
+  @param  RevisionId            A PCI device-specific revision identifier.\r
   @param  SubsystemVendorId     Specifies the subsystem vendor ID.\r
   @param  SubsystemDeviceId     Specifies the subsystem device ID.\r
   @param  Configuration         A list of ACPI resource descriptors that detail\r
@@ -46,32 +57,26 @@ typedef struct _EFI_INCOMPATIBLE_PCI_DEVICE_SUPPORT_PROTOCOL EFI_INCOMPATIBLE_PC
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_INCOMPATIBLE_PCI_DEVICE_SUPPORT_CHECK_DEVICE) (\r
-  IN EFI_INCOMPATIBLE_PCI_DEVICE_SUPPORT_PROTOCOL   *This,\r
+(EFIAPI *EFI_INCOMPATIBLE_PCI_DEVICE_SUPPORT_CHECK_DEVICE)(\r
+  IN  EFI_INCOMPATIBLE_PCI_DEVICE_SUPPORT_PROTOCOL  *This,\r
   IN  UINTN                                         VendorId,\r
   IN  UINTN                                         DeviceId,\r
-  IN  UINTN                                         Revision,\r
-  IN  UINTN                                         SubVendorId,OPTIONAL\r
-  IN  UINTN                                         SubDeviceId,OPTIONAL\r
+  IN  UINTN                                         RevisionId,\r
+  IN  UINTN                                         SubsystemVendorId,\r
+  IN  UINTN                                         SubsystemDeviceId,\r
   OUT VOID                                          **Configuration\r
 );\r
 \r
 \r
-//\r
-// Interface structure for the Incompatible PCI Device Support Protocol\r
-//\r
-/**\r
-  @par Protocol Description:\r
-  This protocol can find some incompatible PCI devices and report their\r
-  special resource requirements to the PCI bus driver.\r
-\r
-  @param CheckDevice\r
-  Returns a list of ACPI resource descriptors that detail any special\r
-  resource configuration requirements if the specified device is a recognized\r
-  incompatible PCI device.\r
-\r
-**/\r
+///\r
+/// Interface structure for the Incompatible PCI Device Support Protocol\r
+///\r
 struct _EFI_INCOMPATIBLE_PCI_DEVICE_SUPPORT_PROTOCOL {\r
+  ///\r
+  ///  Returns a list of ACPI resource descriptors that detail any special\r
+  ///  resource configuration requirements if the specified device is a recognized\r
+  ///  incompatible PCI device.\r
+  ///\r
   EFI_INCOMPATIBLE_PCI_DEVICE_SUPPORT_CHECK_DEVICE      CheckDevice;\r
 };\r
 \r