diff options
author | pkandel <pkandel@6f19259b-4bc3-4df7-8a09-765794883524> | 2009-07-09 12:36:25 +0000 |
---|---|---|
committer | pkandel <pkandel@6f19259b-4bc3-4df7-8a09-765794883524> | 2009-07-09 12:36:25 +0000 |
commit | 7b6b7746627e106f5b1e05990d78c313f14c9081 (patch) | |
tree | a16838f37687071a8b4c79f9002939dbfc0e7907 /IntelFrameworkModulePkg/Include/Protocol/PciHotPlugRequest.h | |
parent | 727fed5a449863c51c7fc5f13f907b23cfb3ea6a (diff) | |
download | edk2-platforms-7b6b7746627e106f5b1e05990d78c313f14c9081.tar.xz |
Committing changes to the comments, to improve code documentation.
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8842 6f19259b-4bc3-4df7-8a09-765794883524
Diffstat (limited to 'IntelFrameworkModulePkg/Include/Protocol/PciHotPlugRequest.h')
-rw-r--r-- | IntelFrameworkModulePkg/Include/Protocol/PciHotPlugRequest.h | 14 |
1 files changed, 6 insertions, 8 deletions
diff --git a/IntelFrameworkModulePkg/Include/Protocol/PciHotPlugRequest.h b/IntelFrameworkModulePkg/Include/Protocol/PciHotPlugRequest.h index d4a36aea0e..40c13498e4 100644 --- a/IntelFrameworkModulePkg/Include/Protocol/PciHotPlugRequest.h +++ b/IntelFrameworkModulePkg/Include/Protocol/PciHotPlugRequest.h @@ -1,6 +1,6 @@ /** @file
- Provides services to notify PCI bus driver that some events have happened in a hot-plug controller
- (for example, PC Card socket, or PHPC), and ask PCI bus driver to create or destroy handles for the
+ Provides services to notify the PCI bus driver that some events have happened in a hot-plug controller
+ (such as a PC Card socket, or PHPC), and to ask the PCI bus driver to create or destroy handles for
PCI-like devices.
Copyright (c) 2006 - 2009, Intel Corporation
@@ -25,7 +25,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. typedef enum {
///
/// The PCI bus driver is requested to create handles for the specified devices. An array of
- /// EFI_HANDLE is returned, a NULL element marks the end of the array.
+ /// EFI_HANDLE is returned, with a NULL element marking the end of the array.
///
EfiPciHotPlugRequestAdd,
@@ -38,18 +38,16 @@ typedef enum { typedef struct _EFI_PCI_HOTPLUG_REQUEST_PROTOCOL EFI_PCI_HOTPLUG_REQUEST_PROTOCOL;
/**
- 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.
-
+ 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.
@param This A pointer to the hot plug request protocol.
@param Operation The operation the PCI bus driver is requested to make.
@param Controller The handle of the hot-plug controller.
@param RemainingDevicePath The remaining device path for the PCI-like hot-plug device.
- @param NumberOfChildren The number of child handles. For a add operation, it is an output parameter.
+ @param NumberOfChildren The number of child handles. For an add operation, it is an output parameter.
For a remove operation, it's an input parameter. When it contains a non-zero
value, children handles specified in ChildHandleBuffer are destroyed. Otherwise,
PCI bus driver is notified to stop managing the controller handle.
- @param ChildHandleBuffer The buffer which contains the child handles. For a add operation, it is an output
+ @param ChildHandleBuffer The buffer which contains the child handles. For an add operation, it is an output
parameter and contains all newly created child handles. For a remove operation, it
contains child handles to be destroyed when NumberOfChildren contains a non-
zero value. It can be NULL when NumberOfChildren is 0. It's the caller's
|