update file header

update function header 

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@6939 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
ywu21 2008-12-10 01:57:01 +00:00
parent 80f0c0c44f
commit f69bf3f5bd
1 changed files with 45 additions and 73 deletions

View File

@ -1,7 +1,7 @@
/** @file /** @file
UEFI Component Name(2) protocol implementation. UEFI Component Name(2) protocol implementation for iSCSI.
Copyright (c) 2004 - 2008, Intel Corporation Copyright (c) 2004 - 2008, Intel Corporation.<BR>
All rights reserved. This program and the accompanying materials All rights reserved. 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
@ -10,14 +10,6 @@ http://opensource.org/licenses/bsd-license.php
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
Module Name:
ComponentName.c
Abstract:
ComponentName protocol for iSCSI.
**/ **/
#include "IScsiImpl.h" #include "IScsiImpl.h"
@ -55,33 +47,23 @@ GLOBAL_REMOVE_IF_UNREFERENCED EFI_UNICODE_STRING_TABLE mIScsiDriverNameTable[] =
by This does not support the language specified by Language, by This does not support the language specified by Language,
then EFI_UNSUPPORTED is returned. then EFI_UNSUPPORTED is returned.
@param This[in] A pointer to the EFI_COMPONENT_NAME_PROTOCOL @param[in] This A pointer to the EFI_COMPONENT_NAME_PROTOCOL instance.
instance. @param[in] Language A pointer to a three character ISO 639-2 language identifier.
This is the language of the driver name that that the caller
@param Language[in] A pointer to a three character ISO 639-2 language is requesting, and it must match one of the languages specified
identifier. in SupportedLanguages. The number of languages supported by a
This is the language of the driver name that that driver is up to the driver writer.
the caller is requesting, and it must match one of @param[out] DriverName A pointer to the Unicode string to return. This Unicode string
the languages specified in SupportedLanguages. is the name of the driver specified by This in the language
The number of languages supported by a driver is up
to the driver writer.
@param DriverName[out] A pointer to the Unicode string to return.
This Unicode string is the name of the
driver specified by This in the language
specified by Language. specified by Language.
@retval EFI_SUCCESS The Unicode string for the Driver specified by @retval EFI_SUCCESS The Unicode string for the Driver specified by This
This and the language specified by Language was and the language specified by Language was returned
returned in DriverName. in DriverName.
@retval EFI_INVALID_PARAMETER Language is NULL. @retval EFI_INVALID_PARAMETER Language is NULL.
@retval EFI_INVALID_PARAMETER DriverName is NULL. @retval EFI_INVALID_PARAMETER DriverName is NULL.
@retval EFI_UNSUPPORTED The driver specified by This does not support the
@retval EFI_UNSUPPORTED The driver specified by This does not support language specified by Language.
the language specified by Language.
**/ **/
EFI_STATUS EFI_STATUS
EFIAPI EFIAPI
@ -102,52 +84,42 @@ IScsiComponentNameGetDriverName (
/** /**
Retrieves a Unicode string that is the user readable name of the controller Retrieves a Unicode string that is the user readable name of the controller
that is being managed by an EFI Driver. that is being managed by an EFI Driver.Currently not implemented.
@param This[in] A pointer to the EFI_COMPONENT_NAME_PROTOCOL instance. @param[in] This A pointer to the EFI_COMPONENT_NAME_PROTOCOL instance.
@param[in] ControllerHandle The handle of a controller that the driver specified by
@param ControllerHandle[in] The handle of a controller that the driver specified by
This is managing. This handle specifies the controller This is managing. This handle specifies the controller
whose name is to be returned. whose name is to be returned.
@param[in] ChildHandle The handle of the child controller to retrieve the name
@param ChildHandle[in] The handle of the child controller to retrieve the name
of. This is an optional parameter that may be NULL. It of. This is an optional parameter that may be NULL. It
will be NULL for device drivers. It will also be NULL will be NULL for device drivers. It will also be NULL
for a bus drivers that wish to retrieve the name of the for a bus drivers that wish to retrieve the name of the
bus controller. It will not be NULL for a bus driver bus controller. It will not be NULL for a bus driver
that wishes to retrieve the name of a child controller. that wishes to retrieve the name of a child controller.
@param[in] Language A pointer to a three character ISO 639-2 language
@param Language[in] A pointer to a three character ISO 639-2 language
identifier. This is the language of the controller name identifier. This is the language of the controller name
that that the caller is requesting, and it must match one that that the caller is requesting, and it must match one
of the languages specified in SupportedLanguages. The of the languages specified in SupportedLanguages. The
number of languages supported by a driver is up to the number of languages supported by a driver is up to the
driver writer. driver writer.
@param[out] ControllerName A pointer to the Unicode string to return. This Unicode
@param ControllerName[out] A pointer to the Unicode string to return. This Unicode
string is the name of the controller specified by string is the name of the controller specified by
ControllerHandle and ChildHandle in the language ControllerHandle and ChildHandle in the language specified
specified by Language from the point of view of the by Language from the point of view of the driver specified
driver specified by This. by This.
@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 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 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.
@retval EFI_UNSUPPORTED The driver specified by This is not currently managing @retval EFI_UNSUPPORTED The driver specified by This is not currently managing
the controller specified by ControllerHandle and ChildHandle. the controller specified by ControllerHandle and
ChildHandle.
@retval EFI_UNSUPPORTED The driver specified by This does not support the @retval EFI_UNSUPPORTED The driver specified by This does not support the
language specified by Language. language specified by Language.
**/ **/
EFI_STATUS EFI_STATUS
EFIAPI EFIAPI