/** @file\r
- Provides services to notify PCI bus driver that some events have happened in a hot-plug controller\r
- (for example, PC Card socket, or PHPC), and ask PCI bus driver to create or destroy handles for the\r
+ Provides services to notify the PCI bus driver that some events have happened in a hot-plug controller\r
+ (such as a PC Card socket, or PHPC), and to ask the PCI bus driver to create or destroy handles for \r
PCI-like devices.\r
\r
Copyright (c) 2006 - 2009, Intel Corporation \r
typedef enum {\r
///\r
/// The PCI bus driver is requested to create handles for the specified devices. An array of\r
- /// EFI_HANDLE is returned, a NULL element marks the end of the array.\r
+ /// EFI_HANDLE is returned, with a NULL element marking the end of the array.\r
///\r
EfiPciHotPlugRequestAdd,\r
\r
typedef struct _EFI_PCI_HOTPLUG_REQUEST_PROTOCOL EFI_PCI_HOTPLUG_REQUEST_PROTOCOL;\r
\r
/**\r
- This function allows the PCI bus driver to be notified to act as requested when a hot-plug event has\r
- happened on the hot-plug controller. Currently, the operations include add operation and remove operation.\r
- \r
+ This function allows the PCI bus driver to be notified to act as requested when a hot-plug event has happened on the hot-plug controller. Currently, the operations include add operation and remove operation. \r
@param This A pointer to the hot plug request protocol.\r
@param Operation The operation the PCI bus driver is requested to make.\r
@param Controller The handle of the hot-plug controller.\r
@param RemainingDevicePath The remaining device path for the PCI-like hot-plug device.\r
- @param NumberOfChildren The number of child handles. For a add operation, it is an output parameter. \r
+ @param NumberOfChildren The number of child handles. For an add operation, it is an output parameter. \r
For a remove operation, it's an input parameter. When it contains a non-zero\r
value, children handles specified in ChildHandleBuffer are destroyed. Otherwise,\r
PCI bus driver is notified to stop managing the controller handle.\r
- @param ChildHandleBuffer The buffer which contains the child handles. For a add operation, it is an output \r
+ @param ChildHandleBuffer The buffer which contains the child handles. For an add operation, it is an output \r
parameter and contains all newly created child handles. For a remove operation, it \r
contains child handles to be destroyed when NumberOfChildren contains a non-\r
zero value. It can be NULL when NumberOfChildren is 0. It's the caller's \r