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

Signed-off-by: niruiyu
Reviewed-by: lgao4

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@11979 6f19259b-4bc3-4df7-8a09-765794883524

17 files changed, 38 insertions, 38 deletions

diff --git a/NetworkPkg/Dhcp6Dxe/ComponentName.c b/NetworkPkg/Dhcp6Dxe/ComponentName.c
index 314ca37d16..178c8bca45 100644
--- a/NetworkPkg/Dhcp6Dxe/ComponentName.c
+++ b/NetworkPkg/Dhcp6Dxe/ComponentName.c
@@ -1,7 +1,7 @@
 /** @file

   UEFI Component Name(2) protocol implementation for Dhcp6 driver.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>

 

   This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

@@ -115,7 +115,7 @@ Dhcp6ComponentNameGetDriverName (
                                 driver specified by This was returned in

                                 DriverName.

 

-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

 

   @retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it is not a valid

                                 EFI_HANDLE.

@@ -281,7 +281,7 @@ Dhcp6ComponentNameGetDriverName (
                                 driver specified by This was returned in

                                 DriverName.

 

-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

 

   @retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it is not a valid

                                 EFI_HANDLE.

diff --git a/NetworkPkg/Dhcp6Dxe/Dhcp6Driver.c b/NetworkPkg/Dhcp6Dxe/Dhcp6Driver.c
index d14f169f07..9bd4c9197a 100644
--- a/NetworkPkg/Dhcp6Dxe/Dhcp6Driver.c
+++ b/NetworkPkg/Dhcp6Dxe/Dhcp6Driver.c
@@ -2,7 +2,7 @@
   Driver Binding functions and Service Binding functions

   implementationfor for Dhcp6 Driver.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>

 

   This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

@@ -686,7 +686,7 @@ ON_ERROR:
 

   @retval EFI_SUCCES            The protocol was removed from ChildHandle.

   @retval EFI_UNSUPPORTED       ChildHandle does not support the protocol that is being removed.

-  @retval EFI_INVALID_PARAMETER Child handle is not a valid UEFI Handle.

+  @retval EFI_INVALID_PARAMETER Child handle is NULL.

   @retval EFI_ACCESS_DENIED     The protocol could not be removed from the ChildHandle

                                 because its services are being used.

   @retval other                 The child handle was not destroyed

diff --git a/NetworkPkg/Dhcp6Dxe/Dhcp6Driver.h b/NetworkPkg/Dhcp6Dxe/Dhcp6Driver.h
index 5a88be4d3b..4ef7f17963 100644
--- a/NetworkPkg/Dhcp6Dxe/Dhcp6Driver.h
+++ b/NetworkPkg/Dhcp6Dxe/Dhcp6Driver.h
@@ -2,7 +2,7 @@
   Driver Binding functions and Service Binding functions

   declaration for Dhcp6 Driver.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>

 

   This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

@@ -139,7 +139,7 @@ Dhcp6ServiceBindingCreateChild (
 

   @retval EFI_SUCCES            The protocol was removed from ChildHandle.

   @retval EFI_UNSUPPORTED       ChildHandle does not support the protocol that is being removed.

-  @retval EFI_INVALID_PARAMETER Child handle is not a valid UEFI Handle.

+  @retval EFI_INVALID_PARAMETER Child handle is NULL.

   @retval EFI_ACCESS_DENIED     The protocol could not be removed from the ChildHandle

                                 because its services are being used.

   @retval other                 The child handle was not destroyed

diff --git a/NetworkPkg/Ip6Dxe/ComponentName.c b/NetworkPkg/Ip6Dxe/ComponentName.c
index c8382f74a9..bcdf4b1e42 100644
--- a/NetworkPkg/Ip6Dxe/ComponentName.c
+++ b/NetworkPkg/Ip6Dxe/ComponentName.c
@@ -2,7 +2,7 @@
   Implementation of EFI_COMPONENT_NAME_PROTOCOL and

   EFI_COMPONENT_NAME2_PROTOCOL protocol.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>

 

   This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

@@ -118,7 +118,7 @@ Ip6ComponentNameGetDriverName (
                                 driver specified by This was returned in

                                 DriverName.

 

-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

 

   @retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it is not a valid

                                 EFI_HANDLE.

@@ -282,7 +282,7 @@ Ip6ComponentNameGetDriverName (
                                 driver specified by This was returned in

                                 DriverName.

 

-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

 

   @retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it is not a valid

                                 EFI_HANDLE.

diff --git a/NetworkPkg/Ip6Dxe/Ip6Driver.c b/NetworkPkg/Ip6Dxe/Ip6Driver.c
index 388dadef8d..502c32bd0d 100644
--- a/NetworkPkg/Ip6Dxe/Ip6Driver.c
+++ b/NetworkPkg/Ip6Dxe/Ip6Driver.c
@@ -1,7 +1,7 @@
 /** @file

   The driver binding and service binding protocol for IP6 driver.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>

 

   This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

@@ -800,7 +800,7 @@ ON_ERROR:
                                  handle.

   @retval EFI_UNSUPPORTED        The child handle does not support the I/O services

                                   that are being removed.

-  @retval EFI_INVALID_PARAMETER  Child handle is not a valid EFI Handle.

+  @retval EFI_INVALID_PARAMETER  Child handle is NULL.

   @retval EFI_ACCESS_DENIED      The child handle could not be destroyed because

                                  its I/O services are being used.

   @retval other                  The child handle was not destroyed.

diff --git a/NetworkPkg/Ip6Dxe/Ip6Driver.h b/NetworkPkg/Ip6Dxe/Ip6Driver.h
index fcb92ab946..48ffe7b06b 100644
--- a/NetworkPkg/Ip6Dxe/Ip6Driver.h
+++ b/NetworkPkg/Ip6Dxe/Ip6Driver.h
@@ -1,7 +1,7 @@
 /** @file

   The driver binding and service binding protocol for IP6 driver.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>

 

   This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

@@ -169,7 +169,7 @@ Ip6ServiceBindingCreateChild (
                                  handle.

   @retval EFI_UNSUPPORTED        The child handle does not support the I/O services

                                   that are being removed.

-  @retval EFI_INVALID_PARAMETER  Child handle is not a valid EFI Handle.

+  @retval EFI_INVALID_PARAMETER  Child handle is NULL.

   @retval EFI_ACCESS_DENIED      The child handle could not be destroyed because

                                  its  I/O services are being used.

   @retval other                  The child handle was not destroyed.

diff --git a/NetworkPkg/IpSecDxe/ComponentName.c b/NetworkPkg/IpSecDxe/ComponentName.c
index 22b3861081..e164d8bbb3 100644
--- a/NetworkPkg/IpSecDxe/ComponentName.c
+++ b/NetworkPkg/IpSecDxe/ComponentName.c
@@ -1,7 +1,7 @@
 /** @file

   UEFI Component Name(2) protocol implementation for IPsec driver.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>

 

   This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

@@ -116,7 +116,7 @@ IpSecComponentNameGetDriverName (
                                 driver specified by This was returned in

                                 DriverName.

 

-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

 

   @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid

                                 EFI_HANDLE.

@@ -279,7 +279,7 @@ IpSecComponentNameGetDriverName (
                                 driver specified by This was returned in

                                 DriverName.

 

-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

 

   @retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it is not a valid

                                 EFI_HANDLE.

diff --git a/NetworkPkg/Mtftp6Dxe/ComponentName.c b/NetworkPkg/Mtftp6Dxe/ComponentName.c
index 0f91b64c44..72a5eb0582 100644
--- a/NetworkPkg/Mtftp6Dxe/ComponentName.c
+++ b/NetworkPkg/Mtftp6Dxe/ComponentName.c
@@ -1,7 +1,7 @@
 /** @file

   UEFI Component Name(2) protocol implementation for Mtftp6 driver.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>

 

   This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

@@ -114,7 +114,7 @@ Mtftp6ComponentNameGetDriverName (
                                 driver specified by This was returned in

                                 DriverName.

 

-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

 

   @retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it is not a valid

                                 EFI_HANDLE.

@@ -277,7 +277,7 @@ Mtftp6ComponentNameGetDriverName (
                                 driver specified by This was returned in

                                 DriverName.

 

-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

 

   @retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it is not a valid

                                 EFI_HANDLE.

diff --git a/NetworkPkg/Mtftp6Dxe/Mtftp6Driver.c b/NetworkPkg/Mtftp6Dxe/Mtftp6Driver.c
index 9aa401e408..28aacf198a 100644
--- a/NetworkPkg/Mtftp6Dxe/Mtftp6Driver.c
+++ b/NetworkPkg/Mtftp6Dxe/Mtftp6Driver.c
@@ -612,7 +612,7 @@ ON_ERROR:
 

   @retval EFI_SUCCES            The protocol was removed from ChildHandle.

   @retval EFI_UNSUPPORTED       ChildHandle does not support the protocol that is being removed.

-  @retval EFI_INVALID_PARAMETER Child handle is not a valid UEFI Handle.

+  @retval EFI_INVALID_PARAMETER Child handle is NULL.

   @retval Others                The child handle was not destroyed

 

 **/

diff --git a/NetworkPkg/Mtftp6Dxe/Mtftp6Driver.h b/NetworkPkg/Mtftp6Dxe/Mtftp6Driver.h
index 7c2b5ae313..3e3165b5e4 100644
--- a/NetworkPkg/Mtftp6Dxe/Mtftp6Driver.h
+++ b/NetworkPkg/Mtftp6Dxe/Mtftp6Driver.h
@@ -137,7 +137,7 @@ Mtftp6ServiceBindingCreateChild (
 

   @retval EFI_SUCCES            The protocol was removed from ChildHandle.

   @retval EFI_UNSUPPORTED       ChildHandle does not support the protocol that is being removed.

-  @retval EFI_INVALID_PARAMETER Child handle is not a valid UEFI Handle.

+  @retval EFI_INVALID_PARAMETER Child handle is NULL.

   @retval Others                The child handle was not destroyed

 

 **/

diff --git a/NetworkPkg/TcpDxe/ComponentName.c b/NetworkPkg/TcpDxe/ComponentName.c
index 956792afec..f1e0e62f73 100644
--- a/NetworkPkg/TcpDxe/ComponentName.c
+++ b/NetworkPkg/TcpDxe/ComponentName.c
@@ -2,7 +2,7 @@
   Implementation of protocols EFI_COMPONENT_NAME_PROTOCOL and

   EFI_COMPONENT_NAME2_PROTOCOL.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>

 

   This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

@@ -116,7 +116,7 @@ TcpComponentNameGetDriverName (
                                 driver specified by This was returned in

                                 DriverName.

 

-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

 

   @retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it is not a valid

                                 EFI_HANDLE.

@@ -275,7 +275,7 @@ TcpComponentNameGetDriverName (
                                 driver specified by This was returned in

                                 DriverName.

 

-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

 

   @retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it is not a valid

                                 EFI_HANDLE.

diff --git a/NetworkPkg/TcpDxe/TcpDriver.c b/NetworkPkg/TcpDxe/TcpDriver.c
index 3e01f34892..c9ac10c758 100644
--- a/NetworkPkg/TcpDxe/TcpDriver.c
+++ b/NetworkPkg/TcpDxe/TcpDriver.c
@@ -823,7 +823,7 @@ TcpServiceBindingCreateChild (
 

   @retval EFI_SUCCES            The protocol was removed from ChildHandle.

   @retval EFI_UNSUPPORTED       ChildHandle does not support the protocol that is being removed.

-  @retval EFI_INVALID_PARAMETER Child handle is not a valid UEFI Handle.

+  @retval EFI_INVALID_PARAMETER Child handle is NULL.

   @retval EFI_ACCESS_DENIED     The protocol could not be removed from the ChildHandle

                                 because its services are being used.

   @retval other                 The child handle was not destroyed.

diff --git a/NetworkPkg/TcpDxe/TcpDriver.h b/NetworkPkg/TcpDxe/TcpDriver.h
index 9de4be617d..3949cd1543 100644
--- a/NetworkPkg/TcpDxe/TcpDriver.h
+++ b/NetworkPkg/TcpDxe/TcpDriver.h
@@ -1,7 +1,7 @@
 /** @file

   The prototype of driver binding and service binding protocol for TCP driver.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>

 

   This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

@@ -214,7 +214,7 @@ TcpServiceBindingCreateChild (
 

   @retval EFI_SUCCES            The protocol was removed from ChildHandle.

   @retval EFI_UNSUPPORTED       ChildHandle does not support the protocol that is being removed.

-  @retval EFI_INVALID_PARAMETER The child handle is not a valid UEFI Handle.

+  @retval EFI_INVALID_PARAMETER The child handle is NULL.

   @retval EFI_ACCESS_DENIED     The protocol could not be removed from the ChildHandle

                                 because its services are being used.

   @retval other                 The child handle was not destroyed.

diff --git a/NetworkPkg/Udp6Dxe/ComponentName.c b/NetworkPkg/Udp6Dxe/ComponentName.c
index d7df0965a0..2511465187 100644
--- a/NetworkPkg/Udp6Dxe/ComponentName.c
+++ b/NetworkPkg/Udp6Dxe/ComponentName.c
@@ -1,7 +1,7 @@
 /** @file

   UEFI Component Name(2) protocol implementation for UDP6 driver.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>

 

   This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

@@ -117,7 +117,7 @@ Udp6ComponentNameGetDriverName (
                                 driver specified by This was returned in

                                 DriverName.

 

-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

 

   @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid

                                 EFI_HANDLE.

@@ -281,7 +281,7 @@ Udp6ComponentNameGetDriverName (
                                 driver specified by This was returned in

                                 DriverName.

 

-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

 

   @retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it is not a valid

                                 EFI_HANDLE.

diff --git a/NetworkPkg/Udp6Dxe/Udp6Driver.c b/NetworkPkg/Udp6Dxe/Udp6Driver.c
index 1cfd5f1b4d..1726ebbde4 100644
--- a/NetworkPkg/Udp6Dxe/Udp6Driver.c
+++ b/NetworkPkg/Udp6Dxe/Udp6Driver.c
@@ -1,7 +1,7 @@
 /** @file

   Driver Binding functions and Service Binding functions for the Network driver module.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>

 

   This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

@@ -398,7 +398,7 @@ ON_ERROR:
                                  handle.

   @retval EFI_UNSUPPORTED        The child handle does not support the I/O services

                                  that are being removed.

-  @retval EFI_INVALID_PARAMETER  Child handle is not a valid EFI Handle.

+  @retval EFI_INVALID_PARAMETER  Child handle is NULL.

   @retval EFI_ACCESS_DENIED      The child handle could not be destroyed because

                                  its  I/O services are being used.

   @retval other                  The child handle was not destroyed.

diff --git a/NetworkPkg/Udp6Dxe/Udp6Driver.h b/NetworkPkg/Udp6Dxe/Udp6Driver.h
index e5a923be68..b40c6f91dc 100644
--- a/NetworkPkg/Udp6Dxe/Udp6Driver.h
+++ b/NetworkPkg/Udp6Dxe/Udp6Driver.h
@@ -1,7 +1,7 @@
 /** @file

   Driver Binding functions and Service Binding functions for the Network driver module.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>

 

   This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

@@ -165,7 +165,7 @@ Udp6ServiceBindingCreateChild (
                                  handle.

   @retval EFI_UNSUPPORTED        The child handle does not support the I/O services

                                  that are being removed.

-  @retval EFI_INVALID_PARAMETER  Child handle is not a valid EFI Handle.

+  @retval EFI_INVALID_PARAMETER  Child handle is NULL.

   @retval EFI_ACCESS_DENIED      The child handle could not be destroyed because

                                  its I/O services are being used.

   @retval other                  The child handle was not destroyed.

diff --git a/NetworkPkg/UefiPxeBcDxe/ComponentName.c b/NetworkPkg/UefiPxeBcDxe/ComponentName.c
index 4228519d18..05e338a7f9 100644
--- a/NetworkPkg/UefiPxeBcDxe/ComponentName.c
+++ b/NetworkPkg/UefiPxeBcDxe/ComponentName.c
@@ -1,7 +1,7 @@
 /** @file

   UEFI Component Name(2) protocol implementation for UefiPxeBc driver.

 

-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>

 

   This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

@@ -114,7 +114,7 @@ PxeBcComponentNameGetDriverName (
                                 driver specified by This was returned in

                                 DriverName.

 

-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

 

   @retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it is not a valid

                                 EFI_HANDLE.

@@ -280,7 +280,7 @@ PxeBcComponentNameGetDriverName (
                                 driver specified by This was returned in

                                 DriverName.

 

-  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

 

   @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid

                                 EFI_HANDLE.