tyler.durden/audk
1
0
Fork 0
mirror of https://github.com/acidanthera/audk.git synced 2025-07-27 07:34:06 +02:00
Code Issues Packages Projects Releases Wiki Activity

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

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

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@11933 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
niruiyu 2011-06-30 03:34:42 +00:00
parent 2525e22198
commit 18bd7e858d
7 changed files with 16 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
MdePkg/Include/Protocol/ComponentName.h
View File

@ -3,7 +3,7 @@
This protocol is used to retrieve user readable names of EFI Drivers This protocol is used to retrieve user readable names of EFI Drivers
and controllers managed by EFI Drivers. and controllers managed by EFI Drivers.
Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR> Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials are licensed and made available under This program and the accompanying materials are licensed and made available under
the terms and conditions of the BSD License that accompanies this distribution. the terms and conditions of the BSD License that accompanies this distribution.
The full text of the license may be found at The full text of the license may be found at
@ -88,7 +88,7 @@ EFI_STATUS
@retval EFI_SUCCESS The Unicode string for the user-readable name in the @retval EFI_SUCCESS The Unicode string for the user-readable name in the
language specified by Language for the driver language specified by Language for the driver
specified by This was returned in DriverName. 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. @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid EFI_HANDLE.
@retval EFI_INVALID_PARAMETER Language is NULL. @retval EFI_INVALID_PARAMETER Language is NULL.
@retval EFI_INVALID_PARAMETER ControllerName is NULL. @retval EFI_INVALID_PARAMETER ControllerName is NULL.

5
MdePkg/Include/Protocol/ComponentName2.h
View File

@ -3,7 +3,7 @@
This protocol is used to retrieve user readable names of drivers This protocol is used to retrieve user readable names of drivers
and controllers managed by UEFI Drivers. and controllers managed by UEFI Drivers.
Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR> Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at which accompanies this distribution. The full text of the license may be found at
@ -119,8 +119,7 @@ EFI_STATUS
driver specified by This was driver specified by This was
returned in DriverName. returned in DriverName.
@retval EFI_INVALID_PARAMETER ControllerHandle is not a valid @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.
EFI_HANDLE.
@retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it
is not a valid EFI_HANDLE. is not a valid EFI_HANDLE.

4
MdePkg/Include/Protocol/DriverDiagnostics.h
View File

@ -1,7 +1,7 @@
/** @file /** @file
EFI Driver Diagnostics Protocol EFI Driver Diagnostics Protocol
Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR> Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials are licensed and made available under This program and the accompanying materials are licensed and made available under
the terms and conditions of the BSD License that accompanies this distribution. the terms and conditions of the BSD License that accompanies this distribution.
The full text of the license may be found at The full text of the license may be found at
@ -73,7 +73,7 @@ typedef enum {
@retval EFI_SUCCESS The controller specified by ControllerHandle and @retval EFI_SUCCESS The controller specified by ControllerHandle and
ChildHandle passed the diagnostic. ChildHandle passed the diagnostic.
@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. @retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it is not a valid EFI_HANDLE.
@retval EFI_INVALID_PARAMETER Language is NULL. @retval EFI_INVALID_PARAMETER Language is NULL.
@retval EFI_INVALID_PARAMETER ErrorType is NULL. @retval EFI_INVALID_PARAMETER ErrorType is NULL.

4
MdePkg/Include/Protocol/DriverDiagnostics2.h
View File

@ -1,7 +1,7 @@
/** @file /** @file
UEFI Driver Diagnostics2 Protocol UEFI Driver Diagnostics2 Protocol
Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR> Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at which accompanies this distribution. The full text of the license may be found at
@ -59,7 +59,7 @@ typedef struct _EFI_DRIVER_DIAGNOSTICS2_PROTOCOL EFI_DRIVER_DIAGNOSTICS2_PROTOC
@retval EFI_ACCESS_DENIED The request for initiating diagnostics was unable @retval EFI_ACCESS_DENIED The request for initiating diagnostics was unable
to be complete due to some underlying hardware or to be complete due to some underlying hardware or
software state. software state.
@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. @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid EFI_HANDLE.
@retval EFI_INVALID_PARAMETER Language is NULL. @retval EFI_INVALID_PARAMETER Language is NULL.
@retval EFI_INVALID_PARAMETER ErrorType is NULL. @retval EFI_INVALID_PARAMETER ErrorType is NULL.

5
MdePkg/Include/Protocol/PlatformToDriverConfiguration.h
View File

@ -99,8 +99,7 @@ typedef struct _EFI_PLATFORM_TO_DRIVER_CONFIGURATION_PROTOCOL EFI_PLATFORM_TO_DR
@retval EFI_NOT_FOUND No more unread Instance exists. @retval EFI_NOT_FOUND No more unread Instance exists.
@retval EFI_INVALID_PARAMETER ControllerHandle is not a valid @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.
EFI_HANDLE.
@retval EFI_INVALID_PARAMETER Instance is NULL. @retval EFI_INVALID_PARAMETER Instance is NULL.
@ -235,7 +234,7 @@ typedef enum {
@retval EFI_NOT_FOUND Instance was not found. @retval EFI_NOT_FOUND Instance was not found.
@retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE. @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.
@retval EFI_INVALID_PARAMETER Instance is zero. @retval EFI_INVALID_PARAMETER Instance is zero.

4
MdePkg/Include/Protocol/ServiceBinding.h
View File

@ -5,7 +5,7 @@
It provides services that are required to create and destroy child It provides services that are required to create and destroy child
handles that support a given set of protocols. handles that support a given set of protocols.
Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR> Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License are licensed and made available under the terms and conditions of the BSD License
which accompanies this distribution. The full text of the license may be found at which accompanies this distribution. The full text of the license may be found at
@ -62,7 +62,7 @@ EFI_STATUS
@retval EFI_SUCCES The protocol was removed from ChildHandle. @retval EFI_SUCCES The protocol was removed from ChildHandle.
@retval EFI_UNSUPPORTED ChildHandle does not support the protocol that is being removed. @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 @retval EFI_ACCESS_DENIED The protocol could not be removed from the ChildHandle
because its services are being used. because its services are being used.
@retval other The child handle was not destroyed @retval other The child handle was not destroyed

8
MdePkg/Include/Uefi/UefiSpec.h
View File

@ -276,7 +276,7 @@ EFI_STATUS
2) No drivers were connected to ControllerHandle, but 2) No drivers were connected to ControllerHandle, but
RemainingDevicePath is not NULL, and it is an End Device RemainingDevicePath is not NULL, and it is an End Device
Path Node. Path Node.
@retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE. @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.
@retval EFI_NOT_FOUND 1) There are no EFI_DRIVER_BINDING_PROTOCOL instances @retval EFI_NOT_FOUND 1) There are no EFI_DRIVER_BINDING_PROTOCOL instances
present in the system. present in the system.
2) No drivers were connected to ControllerHandle. 2) No drivers were connected to ControllerHandle.
@ -1167,7 +1167,7 @@ EFI_STATUS
@retval EFI_ACCESS_DENIED The protocol interface could not be reinstalled, @retval EFI_ACCESS_DENIED The protocol interface could not be reinstalled,
because OldInterface is still being used by a because OldInterface is still being used by a
driver that will not release it. driver that will not release it.
@retval EFI_INVALID_PARAMETER Handle is not a valid EFI_HANDLE. @retval EFI_INVALID_PARAMETER Handle is NULL.
@retval EFI_INVALID_PARAMETER Protocol is NULL. @retval EFI_INVALID_PARAMETER Protocol is NULL.
**/ **/
@ -1193,7 +1193,7 @@ EFI_STATUS
@retval EFI_NOT_FOUND The interface was not found. @retval EFI_NOT_FOUND The interface was not found.
@retval EFI_ACCESS_DENIED The interface was not removed because the interface @retval EFI_ACCESS_DENIED The interface was not removed because the interface
is still being used by a driver. is still being used by a driver.
@retval EFI_INVALID_PARAMETER Handle is not a valid EFI_HANDLE. @retval EFI_INVALID_PARAMETER Handle is NULL.
@retval EFI_INVALID_PARAMETER Protocol is NULL. @retval EFI_INVALID_PARAMETER Protocol is NULL.
**/ **/
@ -1233,7 +1233,7 @@ EFI_STATUS
@retval EFI_SUCCESS The interface information for the specified protocol was returned. @retval EFI_SUCCESS The interface information for the specified protocol was returned.
@retval EFI_UNSUPPORTED The device does not support the specified protocol. @retval EFI_UNSUPPORTED The device does not support the specified protocol.
@retval EFI_INVALID_PARAMETER Handle is not a valid EFI_HANDLE. @retval EFI_INVALID_PARAMETER Handle is NULL.
@retval EFI_INVALID_PARAMETER Protocol is NULL. @retval EFI_INVALID_PARAMETER Protocol is NULL.
@retval EFI_INVALID_PARAMETER Interface is NULL. @retval EFI_INVALID_PARAMETER Interface is NULL.