bbcf90a9 |
1 | /** @file |
2 | |
3 | Copyright (c) 2006 - 2007 Intel Corporation. All rights reserved |
4 | All rights reserved. This program and the accompanying materials |
5 | are licensed and made available under the terms and conditions of the BSD License |
6 | which accompanies this distribution. The full text of the license may be found at |
7 | http://opensource.org/licenses/bsd-license.php |
8 | |
9 | THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, |
10 | WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. |
11 | |
bbcf90a9 |
12 | **/ |
13 | |
14 | #include "VgaMiniPort.h" |
15 | |
16 | // |
17 | // EFI Component Name Functions |
18 | // |
19 | EFI_STATUS |
20 | EFIAPI |
21 | PciVgaMiniPortComponentNameGetDriverName ( |
22 | IN EFI_COMPONENT_NAME_PROTOCOL *This, |
23 | IN CHAR8 *Language, |
24 | OUT CHAR16 **DriverName |
25 | ); |
26 | |
27 | EFI_STATUS |
28 | EFIAPI |
29 | PciVgaMiniPortComponentNameGetControllerName ( |
30 | IN EFI_COMPONENT_NAME_PROTOCOL *This, |
31 | IN EFI_HANDLE ControllerHandle, |
32 | IN EFI_HANDLE ChildHandle OPTIONAL, |
33 | IN CHAR8 *Language, |
34 | OUT CHAR16 **ControllerName |
35 | ); |
36 | |
37 | // |
38 | // EFI Component Name Protocol |
39 | // |
40 | EFI_COMPONENT_NAME_PROTOCOL gPciVgaMiniPortComponentName = { |
41 | PciVgaMiniPortComponentNameGetDriverName, |
42 | PciVgaMiniPortComponentNameGetControllerName, |
43 | "eng" |
44 | }; |
45 | |
46 | static EFI_UNICODE_STRING_TABLE mPciVgaMiniPortDriverNameTable[] = { |
47 | { |
48 | "eng", |
49 | L"PCI VGA Mini Port Driver" |
50 | }, |
51 | { |
52 | NULL, |
53 | NULL |
54 | } |
55 | }; |
56 | |
57 | EFI_STATUS |
58 | EFIAPI |
59 | PciVgaMiniPortComponentNameGetDriverName ( |
60 | IN EFI_COMPONENT_NAME_PROTOCOL *This, |
61 | IN CHAR8 *Language, |
62 | OUT CHAR16 **DriverName |
63 | ) |
64 | /*++ |
65 | |
66 | Routine Description: |
67 | Retrieves a Unicode string that is the user readable name of the EFI Driver. |
68 | |
69 | Arguments: |
70 | This - A pointer to the EFI_COMPONENT_NAME_PROTOCOL instance. |
71 | Language - A pointer to a three character ISO 639-2 language identifier. |
72 | This is the language of the driver name that that the caller |
73 | is requesting, and it must match one of the languages specified |
74 | in SupportedLanguages. The number of languages supported by a |
75 | driver is up to the driver writer. |
76 | DriverName - A pointer to the Unicode string to return. This Unicode string |
77 | is the name of the driver specified by This in the language |
78 | specified by Language. |
79 | |
80 | Returns: |
81 | EFI_SUCCESS - The Unicode string for the Driver specified by This |
82 | and the language specified by Language was returned |
83 | in DriverName. |
84 | EFI_INVALID_PARAMETER - Language is NULL. |
85 | EFI_INVALID_PARAMETER - DriverName is NULL. |
86 | EFI_UNSUPPORTED - The driver specified by This does not support the |
87 | language specified by Language. |
88 | |
89 | --*/ |
90 | { |
91 | return LookupUnicodeString ( |
92 | Language, |
93 | gPciVgaMiniPortComponentName.SupportedLanguages, |
94 | mPciVgaMiniPortDriverNameTable, |
95 | DriverName |
96 | ); |
97 | } |
98 | |
99 | EFI_STATUS |
100 | EFIAPI |
101 | PciVgaMiniPortComponentNameGetControllerName ( |
102 | IN EFI_COMPONENT_NAME_PROTOCOL *This, |
103 | IN EFI_HANDLE ControllerHandle, |
104 | IN EFI_HANDLE ChildHandle OPTIONAL, |
105 | IN CHAR8 *Language, |
106 | OUT CHAR16 **ControllerName |
107 | ) |
108 | /*++ |
109 | |
110 | Routine Description: |
111 | Retrieves a Unicode string that is the user readable name of the controller |
112 | that is being managed by an EFI Driver. |
113 | |
114 | Arguments: |
115 | This - A pointer to the EFI_COMPONENT_NAME_PROTOCOL instance. |
116 | ControllerHandle - The handle of a controller that the driver specified by |
117 | This is managing. This handle specifies the controller |
118 | whose name is to be returned. |
119 | ChildHandle - The handle of the child controller to retrieve the name |
120 | of. This is an optional parameter that may be NULL. It |
121 | will be NULL for device drivers. It will also be NULL |
122 | for a bus drivers that wish to retrieve the name of the |
123 | bus controller. It will not be NULL for a bus driver |
124 | that wishes to retrieve the name of a child controller. |
125 | Language - A pointer to a three character ISO 639-2 language |
126 | identifier. This is the language of the controller name |
127 | that that the caller is requesting, and it must match one |
128 | of the languages specified in SupportedLanguages. The |
129 | number of languages supported by a driver is up to the |
130 | driver writer. |
131 | ControllerName - A pointer to the Unicode string to return. This Unicode |
132 | string is the name of the controller specified by |
133 | ControllerHandle and ChildHandle in the language |
134 | specified by Language from the point of view of the |
135 | driver specified by This. |
136 | |
137 | Returns: |
138 | EFI_SUCCESS - The Unicode string for the user readable name in the |
139 | language specified by Language for the driver |
140 | specified by This was returned in DriverName. |
141 | EFI_INVALID_PARAMETER - ControllerHandle is not a valid EFI_HANDLE. |
142 | EFI_INVALID_PARAMETER - ChildHandle is not NULL and it is not a valid |
143 | EFI_HANDLE. |
144 | EFI_INVALID_PARAMETER - Language is NULL. |
145 | EFI_INVALID_PARAMETER - ControllerName is NULL. |
146 | EFI_UNSUPPORTED - The driver specified by This is not currently |
147 | managing the controller specified by |
148 | ControllerHandle and ChildHandle. |
149 | EFI_UNSUPPORTED - The driver specified by This does not support the |
150 | language specified by Language. |
151 | |
152 | --*/ |
153 | { |
154 | return EFI_UNSUPPORTED; |
155 | } |