Fix the comments to follow UEFI Spec regarding how to check an EFI_HANDLE is valid...

Signed-off-by: niruiyu
Reviewed-by: lgao4
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@11985 6f19259b-4bc3-4df7-8a09-765794883524

diff --git a/MdePkg/Include/Protocol/PlatformDriverOverride.h b/MdePkg/Include/Protocol/PlatformDriverOverride.h
index c9d55216ea0edd1e9fac97dc8b87926cbf1975d3..0fe42fc0a6742ea9901fba2d658ee0ea3e0d9a05 100644 (file)
--- a/MdePkg/Include/Protocol/PlatformDriverOverride.h
+++ b/MdePkg/Include/Protocol/PlatformDriverOverride.h
@@ -1,7 +1,7 @@
 /** @file\r
   Platform Driver Override protocol as defined in the UEFI 2.1 specification.\r
 \r
-  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>\r
+  Copyright (c) 2006 - 2011, 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
@@ -43,7 +43,7 @@ typedef struct _EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL  EFI_PLATFORM_DRIVER_OVERR
   @retval EFI_SUCCESS           The driver override for ControllerHandle was returned in\r
                                 DriverImageHandle.                                      \r
   @retval EFI_NOT_FOUND         A driver override for ControllerHandle was not found.\r
-  @retval EFI_INVALID_PARAMETER The handle specified by ControllerHandle is not a valid handle.\r
+  @retval EFI_INVALID_PARAMETER The handle specified by ControllerHandle is NULL.\r
   @retval EFI_INVALID_PARAMETER DriverImageHandle is not a handle that was returned on a\r
                                 previous call to GetDriver().                           \r
                                    \r
@@ -59,8 +59,7 @@ EFI_STATUS
 /**                                                                 \r
   Retrieves the device path of the platform override driver for a controller in the system.\r
     \r
-  @param  This                  A pointer to the EFI_PLATFORM_DRIVER_OVERRIDE_\r
-                                PROTOCOL instance.                            \r
+  @param  This                  A pointer to the EFI_PLATFORM_DRIVER_OVERRIDE_PROTOCOL instance.\r
   @param  ControllerHandle      The device handle of the controller to check if a driver override\r
                                 exists.                                                          \r
   @param  DriverImagePath       On input, a pointer to the previous driver device path returned by\r
@@ -72,7 +71,7 @@ EFI_STATUS
                                 DriverImageHandle.                                      \r
   @retval EFI_UNSUPPORTED       The operation is not supported.                                \r
   @retval EFI_NOT_FOUND         A driver override for ControllerHandle was not found.\r
-  @retval EFI_INVALID_PARAMETER The handle specified by ControllerHandle is not a valid handle.\r
+  @retval EFI_INVALID_PARAMETER The handle specified by ControllerHandle is NULL.\r
   @retval EFI_INVALID_PARAMETER DriverImagePath is not a device path that was returned on a\r
                                 previous call to GetDriverPath().                          \r
                                    \r
@@ -106,7 +105,7 @@ EFI_STATUS
   @retval EFI_NOT_FOUND         DriverImagePath is not a device path that was returned on a prior\r
                                 call to GetDriverPath() for the controller specified by          \r
                                 ControllerHandle.                                                \r
-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid device handle.\r
+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.\r
   @retval EFI_INVALID_PARAMETER DriverImagePath is not a valid device path.\r
   @retval EFI_INVALID_PARAMETER DriverImageHandle is not a valid image handle.\r
                                    \r

diff --git a/MdePkg/Include/Uefi/UefiSpec.h b/MdePkg/Include/Uefi/UefiSpec.h
index b6441c612a0e45036af81b5e557b421ab9cfd0f2..7dbac451b237cbec4efad00723e76687e671c4e5 100644 (file)
--- a/MdePkg/Include/Uefi/UefiSpec.h
+++ b/MdePkg/Include/Uefi/UefiSpec.h
@@ -306,7 +306,7 @@ EFI_STATUS
                                 2) On entry, no drivers are managing ControllerHandle.\r
                                 3) DriverImageHandle is not NULL, and on entry\r
                                    DriverImageHandle is not managing ControllerHandle.\r
-  @retval EFI_INVALID_PARAMETER 1) ControllerHandle is not a valid EFI_HANDLE.\r
+  @retval EFI_INVALID_PARAMETER 1) ControllerHandle is NULL.\r
                                 2) DriverImageHandle is not NULL, and it is not a valid EFI_HANDLE.\r
                                 3) ChildHandle is not NULL, and it is not a valid EFI_HANDLE.\r
                                 4) DriverImageHandle does not support the EFI_DRIVER_BINDING_PROTOCOL.\r
@@ -1304,8 +1304,8 @@ EFI_STATUS
                                 that required the protocol interface.\r
 \r
   @retval EFI_SUCCESS           The protocol instance was closed.\r
-  @retval EFI_INVALID_PARAMETER 1) Handle is not a valid EFI_HANDLE.\r
-                                2) AgentHandle is not a valid EFI_HANDLE.\r
+  @retval EFI_INVALID_PARAMETER 1) Handle is NULL.\r
+                                2) AgentHandle is NULL.\r
                                 3) ControllerHandle is not NULL and ControllerHandle is not a valid EFI_HANDLE.\r
                                 4) Protocol is NULL.\r
   @retval EFI_NOT_FOUND         1) Handle does not support the protocol specified by Protocol.\r