Intel Extensible Firmware Interface - Manual (Page 292)

Extensible Firmware Interface Specification
9-50 12/01/02 Version 1.10
EFI_COMPONENT_NAME_PROTOCOL.GetControllerName()
Summary
Retrieves a Unicode string that is the user readable name of the controller that is being managed by
an EFI Driver.
Prototype
typedef
EFI_STATUS
(EFIAPI *EFI_COMPONENT_NAME_GET_CONTROLLER_NAME) (
IN EFI_COMPONENT_NAME_PROTOCOL
*This,
IN EFI_HANDLE ControllerHandle,
IN EFI_HANDLE ChildHandle OPTIONAL,
IN CHAR8 *Language,
OUT CHAR16 **ControllerName
);
Parameters
This A pointer to the EFI_COMPONENT_NAME_PROTOCOL
instance.
ControllerHandle The handle of a controller that the driver specified by This is
managing. This handle specifies the controller whose name is to
be returned.
ChildHandle The handle of the child controller to retrieve the name of. This is
an optional parameter that may be
NULL . It will be NULL for
device drivers. It will also be NULL for a bus drivers that wish
to retrieve the name of the bus controller. It will not be NULL
for a bus driver that wishes to retrieve the name of a child
controller.
Language A pointer to a three character ISO 639-2 language identifier.
This is the language of the controller name that that the caller is
requesting, and it must match one of the languages specified in
SupportedLanguages . The number of languages supported
by a driver is up to the driver writer.
ControllerName A pointer to the Unicode string to return. This Unicode string is
the name of the controller specified by
ControllerHandle
and ChildHandle in the language specified by Language
from the point of view of the driver specified by This .