[mirror_edk2.git] / MdePkg / Library / UefiRuntimeLib / RuntimeService.c

/*++\r
\r
Copyright (c) 2006 - 2007, Intel Corporation\r
All rights reserved. This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution.  The full text of the license may be found at\r
http://opensource.org/licenses/bsd-license.php\r
\r
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
--*/\r
\r
#include <PiDxe.h>\r
\r
#include <RuntimeLibInternal.h>\r
\r
VOID\r
EFIAPI\r
EfiResetSystem (\r
  IN EFI_RESET_TYPE               ResetType,\r
  IN EFI_STATUS                   ResetStatus,\r
  IN UINTN                        DataSize,\r
  IN CHAR16                       *ResetData\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  Resets the entire platform.\r
\r
Arguments:\r
\r
  ResetType   - The type of reset to perform.\r
  ResetStatus - The status code for the reset.\r
  DataSize    - The size, in bytes, of ResetData.\r
  ResetData   - A data buffer that includes a Null-terminated Unicode string, optionally\r
                followed by additional binary data.\r
\r
Returns:\r
\r
  None\r
\r
--*/\r
{\r
  mRT->ResetSystem (ResetType, ResetStatus, DataSize, ResetData);\r
}\r
\r
//\r
// The following functions hide the mRT local global from the call to\r
// runtime service in the EFI system table.\r
//\r
EFI_STATUS\r
EFIAPI\r
EfiGetTime (\r
  OUT EFI_TIME                    *Time,\r
  OUT EFI_TIME_CAPABILITIES       *Capabilities\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  Returns the current time and date information, and the time-keeping\r
  capabilities of the hardware platform.\r
\r
Arguments:\r
\r
  Time          - A pointer to storage to receive a snapshot of the current time.\r
  Capabilities  - An optional pointer to a buffer to receive the real time clock device's\r
                  capabilities.\r
\r
Returns:\r
\r
  Status code\r
\r
--*/\r
{\r
  return mRT->GetTime (Time, Capabilities);\r
}\r
\r
EFI_STATUS\r
EFIAPI\r
EfiSetTime (\r
  IN EFI_TIME                   *Time\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  Sets the current local time and date information.\r
\r
Arguments:\r
\r
  Time  - A pointer to the current time.\r
\r
Returns:\r
\r
  Status code\r
\r
--*/\r
{\r
  return mRT->SetTime (Time);\r
}\r
\r
EFI_STATUS\r
EFIAPI\r
EfiGetWakeupTime (\r
  OUT BOOLEAN                     *Enabled,\r
  OUT BOOLEAN                     *Pending,\r
  OUT EFI_TIME                    *Time\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  Returns the current wakeup alarm clock setting.\r
\r
Arguments:\r
\r
  Enabled - Indicates if the alarm is currently enabled or disabled.\r
  Pending - Indicates if the alarm signal is pending and requires acknowledgement.\r
  Time    - The current alarm setting.\r
\r
Returns:\r
\r
  Status code\r
\r
--*/\r
{\r
  return mRT->GetWakeupTime (Enabled, Pending, Time);\r
}\r
\r
EFI_STATUS\r
EFIAPI\r
EfiSetWakeupTime (\r
  IN BOOLEAN                      Enable,\r
  IN EFI_TIME                     *Time\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  Sets the system wakeup alarm clock time.\r
\r
Arguments:\r
\r
  Enable  - Enable or disable the wakeup alarm.\r
  Time    - If Enable is TRUE, the time to set the wakeup alarm for.\r
            If Enable is FALSE, then this parameter is optional, and may be NULL.\r
\r
Returns:\r
\r
  Status code\r
\r
--*/\r
{\r
  return mRT->SetWakeupTime (Enable, Time);\r
}\r
\r
\r
\r
\r
EFI_STATUS\r
EFIAPI\r
EfiGetVariable (\r
  IN CHAR16                       *VariableName,\r
  IN EFI_GUID                     * VendorGuid,\r
  OUT UINT32                      *Attributes OPTIONAL,\r
  IN OUT UINTN                    *DataSize,\r
  OUT VOID                        *Data\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  Returns the value of a variable.\r
\r
Arguments:\r
\r
  VariableName  - A Null-terminated Unicode string that is the name of the\r
                  vendor's variable.\r
  VendorGuid    - A unique identifier for the vendor.\r
  Attributes    - If not NULL, a pointer to the memory location to return the\r
                  attributes bitmask for the variable.\r
  DataSize      - On input, the size in bytes of the return Data buffer.\r
                  On output the size of data returned in Data.\r
  Data          - The buffer to return the contents of the variable.\r
\r
Returns:\r
\r
  Status code\r
\r
--*/\r
{\r
  return mRT->GetVariable (VariableName, VendorGuid, Attributes, DataSize, Data);\r
}\r
\r
EFI_STATUS\r
EFIAPI\r
EfiGetNextVariableName (\r
  IN OUT UINTN                    *VariableNameSize,\r
  IN OUT CHAR16                   *VariableName,\r
  IN OUT EFI_GUID                 *VendorGuid\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  Enumerates the current variable names.\r
\r
Arguments:\r
\r
  VariableNameSize  - The size of the VariableName buffer.\r
  VariableName      - On input, supplies the last VariableName that was returned\r
                      by GetNextVariableName().\r
                      On output, returns the Nullterminated Unicode string of the\r
                      current variable.\r
  VendorGuid        - On input, supplies the last VendorGuid that was returned by\r
                      GetNextVariableName().\r
                      On output, returns the VendorGuid of the current variable.\r
\r
Returns:\r
\r
  Status code\r
\r
--*/\r
{\r
  return mRT->GetNextVariableName (VariableNameSize, VariableName, VendorGuid);\r
}\r
\r
EFI_STATUS\r
EFIAPI\r
EfiSetVariable (\r
  IN CHAR16                       *VariableName,\r
  IN EFI_GUID                     *VendorGuid,\r
  IN UINT32                       Attributes,\r
  IN UINTN                        DataSize,\r
  IN VOID                         *Data\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  Sets the value of a variable.\r
\r
Arguments:\r
\r
  VariableName  - A Null-terminated Unicode string that is the name of the\r
                  vendor's variable.\r
  VendorGuid    - A unique identifier for the vendor.\r
  Attributes    - Attributes bitmask to set for the variable.\r
  DataSize      - The size in bytes of the Data buffer.\r
  Data          - The contents for the variable.\r
\r
Returns:\r
\r
  Status code\r
\r
--*/\r
{\r
  return mRT->SetVariable (VariableName, VendorGuid, Attributes, DataSize, Data);\r
}\r
\r
EFI_STATUS\r
EFIAPI\r
EfiGetNextHighMonotonicCount (\r
  OUT UINT32                      *HighCount\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  Returns the next high 32 bits of the platform's monotonic counter.\r
\r
Arguments:\r
\r
  HighCount - Pointer to returned value.\r
\r
Returns:\r
\r
  Status code\r
\r
--*/\r
{\r
  return mRT->GetNextHighMonotonicCount (HighCount);\r
}\r
\r
EFI_STATUS\r
EFIAPI\r
EfiConvertPointer (\r
  IN UINTN                  DebugDisposition,\r
  IN OUT VOID               **Address\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  Determines the new virtual address that is to be used on subsequent memory accesses.\r
\r
Arguments:\r
\r
  DebugDisposition  - Supplies type information for the pointer being converted.\r
  Address           - A pointer to a pointer that is to be fixed to be the value needed\r
                      for the new virtual address mappings being applied.\r
\r
Returns:\r
\r
  Status code\r
\r
--*/\r
{\r
  return mRT->ConvertPointer (DebugDisposition, Address);\r
}\r
\r
EFI_STATUS\r
EFIAPI\r
EfiConvertList (\r
  IN UINTN                DebugDisposition,\r
  IN OUT LIST_ENTRY       *ListHead\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  Conver the standard Lib double linked list to a virtual mapping.\r
\r
Arguments:\r
\r
  DebugDisposition - Argument to EfiConvertPointer (EFI 1.0 API)\r
\r
  ListHead         - Head of linked list to convert\r
\r
Returns:\r
\r
  EFI_SUCCESS\r
\r
--*/\r
{\r
  LIST_ENTRY  *Link;\r
  LIST_ENTRY  *NextLink;\r
\r
  //\r
  // Convert all the ForwardLink & BackLink pointers in the list\r
  //\r
  Link = ListHead;\r
  do {\r
    NextLink = Link->ForwardLink;\r
\r
    EfiConvertPointer (\r
      Link->ForwardLink == ListHead ? DebugDisposition : 0,\r
      (VOID **) &Link->ForwardLink\r
      );\r
\r
    EfiConvertPointer (\r
      Link->BackLink == ListHead ? DebugDisposition : 0,\r
      (VOID **) &Link->BackLink\r
      );\r
\r
    Link = NextLink;\r
  } while (Link != ListHead);\r
  return EFI_SUCCESS;\r
}\r
\r
\r
/**\r
  Change the runtime addressing mode of EFI firmware from physical to virtual.\r
\r
  @param  MemoryMapSize         The size in bytes of VirtualMap.\r
  @param  DescriptorSize        The size in bytes of an entry in the VirtualMap.\r
  @param  DescriptorVersion     The version of the structure entries in VirtualMap.\r
  @param  VirtualMap            An array of memory descriptors which contain new virtual\r
                                address mapping information for all runtime ranges. Type\r
                                EFI_MEMORY_DESCRIPTOR is defined in the\r
                                GetMemoryMap() function description.\r
\r
  @retval EFI_SUCCESS           The virtual address map has been applied.\r
  @retval EFI_UNSUPPORTED       EFI firmware is not at runtime, or the EFI firmware is already in\r
                                virtual address mapped mode.\r
  @retval EFI_INVALID_PARAMETER DescriptorSize or DescriptorVersion is\r
                                invalid.\r
  @retval EFI_NO_MAPPING        A virtual address was not supplied for a range in the memory\r
                                map that requires a mapping.\r
  @retval EFI_NOT_FOUND         A virtual address was supplied for an address that is not found\r
                                in the memory map.\r
**/\r
EFI_STATUS\r
EFIAPI\r
EfiSetVirtualAddressMap (\r
  IN UINTN                          MemoryMapSize,\r
  IN UINTN                          DescriptorSize,\r
  IN UINT32                         DescriptorVersion,\r
  IN CONST EFI_MEMORY_DESCRIPTOR    *VirtualMap\r
  )\r
{\r
  return mRT->SetVirtualAddressMap (\r
                MemoryMapSize,\r
                DescriptorSize,\r
                DescriptorVersion,\r
                (EFI_MEMORY_DESCRIPTOR *) VirtualMap\r
                );\r
}\r
\r
\r
EFI_STATUS\r
EFIAPI\r
EfiUpdateCapsule (\r
  IN EFI_CAPSULE_HEADER   **CapsuleHeaderArray,\r
  IN UINTN                CapsuleCount,\r
  IN EFI_PHYSICAL_ADDRESS ScatterGatherList OPTIONAL\r
  )\r
{\r
  return mRT->UpdateCapsule (\r
                CapsuleHeaderArray,\r
                CapsuleCount,\r
                ScatterGatherList\r
                );\r
}\r
\r
EFI_STATUS\r
EFIAPI\r
EfiQueryCapsuleCapabilities (\r
  IN EFI_CAPSULE_HEADER   **CapsuleHeaderArray,\r
  IN UINTN                CapsuleCount,\r
  OUT UINT64              *MaximumCapsuleSize,\r
  OUT EFI_RESET_TYPE      *ResetType\r
  )\r
{\r
  return mRT->QueryCapsuleCapabilities (\r
          CapsuleHeaderArray,\r
          CapsuleCount,\r
          MaximumCapsuleSize,\r
          ResetType\r
          );\r
}\r
\r
\r
EFI_STATUS\r
EFIAPI\r
EfiQueryVariableInfo (\r
  IN  UINT32      Attributes,\r
  OUT UINT64      *MaximumVariableStorageSize,\r
  OUT UINT64      *RemainingVariableStorageSize,\r
  OUT UINT64      *MaximumVariableSize\r
  )\r
{\r
  return mRT->QueryVariableInfo (\r
          Attributes,\r
          MaximumVariableStorageSize,\r
          RemainingVariableStorageSize,\r
          MaximumVariableSize\r
          );\r
}\r
Commit	Line	Data
ebcc8fb7	1	/*++\r
	2	\r
	3	Copyright (c) 2006 - 2007, Intel Corporation\r
	4	All rights reserved. This program and the accompanying materials\r
	5	are licensed and made available under the terms and conditions of the BSD License\r
	6	which accompanies this distribution. The full text of the license may be found at\r
	7	http://opensource.org/licenses/bsd-license.php\r
	8	\r
	9	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
	10	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
	11	\r
ebcc8fb7	12	--*/\r
	13	\r
	14	#include <PiDxe.h>\r
ebcc8fb7	15	\r
	16	#include <RuntimeLibInternal.h>\r
	17	\r
	18	VOID\r
	19	EFIAPI\r
	20	EfiResetSystem (\r
	21	IN EFI_RESET_TYPE ResetType,\r
	22	IN EFI_STATUS ResetStatus,\r
	23	IN UINTN DataSize,\r
	24	IN CHAR16 *ResetData\r
	25	)\r
	26	/*++\r
	27	\r
	28	Routine Description:\r
	29	\r
	30	Resets the entire platform.\r
	31	\r
	32	Arguments:\r
	33	\r
	34	ResetType - The type of reset to perform.\r
	35	ResetStatus - The status code for the reset.\r
	36	DataSize - The size, in bytes, of ResetData.\r
	37	ResetData - A data buffer that includes a Null-terminated Unicode string, optionally\r
	38	followed by additional binary data.\r
	39	\r
	40	Returns:\r
	41	\r
	42	None\r
	43	\r
	44	--*/\r
	45	{\r
	46	mRT->ResetSystem (ResetType, ResetStatus, DataSize, ResetData);\r
	47	}\r
	48	\r
	49	//\r
	50	// The following functions hide the mRT local global from the call to\r
	51	// runtime service in the EFI system table.\r
	52	//\r
	53	EFI_STATUS\r
	54	EFIAPI\r
	55	EfiGetTime (\r
	56	OUT EFI_TIME *Time,\r
	57	OUT EFI_TIME_CAPABILITIES *Capabilities\r
	58	)\r
	59	/*++\r
	60	\r
	61	Routine Description:\r
	62	\r
	63	Returns the current time and date information, and the time-keeping\r
	64	capabilities of the hardware platform.\r
	65	\r
	66	Arguments:\r
	67	\r
	68	Time - A pointer to storage to receive a snapshot of the current time.\r
	69	Capabilities - An optional pointer to a buffer to receive the real time clock device's\r
	70	capabilities.\r
	71	\r
	72	Returns:\r
	73	\r
	74	Status code\r
	75	\r
	76	--*/\r
	77	{\r
	78	return mRT->GetTime (Time, Capabilities);\r
79	}\r
80	\r
81	EFI_STATUS\r
82	EFIAPI\r
83	EfiSetTime (\r
84	IN EFI_TIME *Time\r
85	)\r
86	/*++\r
87	\r
88	Routine Description:\r
89	\r
90	Sets the current local time and date information.\r
91	\r
92	Arguments:\r
93	\r
94	Time - A pointer to the current time.\r
95	\r
96	Returns:\r
97	\r
98	Status code\r
99	\r
100	--*/\r
101	{\r
102	return mRT->SetTime (Time);\r
103	}\r
104	\r
105	EFI_STATUS\r
106	EFIAPI\r
107	EfiGetWakeupTime (\r
108	OUT BOOLEAN *Enabled,\r
109	OUT BOOLEAN *Pending,\r
110	OUT EFI_TIME *Time\r
111	)\r
112	/*++\r
113	\r
114	Routine Description:\r
115	\r
116	Returns the current wakeup alarm clock setting.\r
117	\r
118	Arguments:\r
119	\r
120	Enabled - Indicates if the alarm is currently enabled or disabled.\r
121	Pending - Indicates if the alarm signal is pending and requires acknowledgement.\r
122	Time - The current alarm setting.\r
123	\r
124	Returns:\r
125	\r
126	Status code\r
127	\r
128	--*/\r
129	{\r
130	return mRT->GetWakeupTime (Enabled, Pending, Time);\r
131	}\r
132	\r
133	EFI_STATUS\r
134	EFIAPI\r
135	EfiSetWakeupTime (\r
136	IN BOOLEAN Enable,\r
137	IN EFI_TIME *Time\r
138	)\r
139	/*++\r
140	\r
141	Routine Description:\r
142	\r
143	Sets the system wakeup alarm clock time.\r
144	\r
145	Arguments:\r
146	\r
147	Enable - Enable or disable the wakeup alarm.\r
148	Time - If Enable is TRUE, the time to set the wakeup alarm for.\r
149	If Enable is FALSE, then this parameter is optional, and may be NULL.\r
150	\r
151	Returns:\r
152	\r
153	Status code\r
154	\r
155	--*/\r
156	{\r
157	return mRT->SetWakeupTime (Enable, Time);\r
158	}\r
159	\r
160	\r
161	\r
162	\r
163	EFI_STATUS\r
164	EFIAPI\r
165	EfiGetVariable (\r
166	IN CHAR16 *VariableName,\r
167	IN EFI_GUID * VendorGuid,\r
168	OUT UINT32 *Attributes OPTIONAL,\r
169	IN OUT UINTN *DataSize,\r
170	OUT VOID *Data\r
171	)\r
172	/*++\r
173	\r
174	Routine Description:\r
175	\r
176	Returns the value of a variable.\r
177	\r
178	Arguments:\r
179	\r
180	VariableName - A Null-terminated Unicode string that is the name of the\r
181	vendor's variable.\r
182	VendorGuid - A unique identifier for the vendor.\r
183	Attributes - If not NULL, a pointer to the memory location to return the\r
184	attributes bitmask for the variable.\r
185	DataSize - On input, the size in bytes of the return Data buffer.\r
186	On output the size of data returned in Data.\r
187	Data - The buffer to return the contents of the variable.\r
188	\r
189	Returns:\r
190	\r
191	Status code\r
192	\r
193	--*/\r
194	{\r
195	return mRT->GetVariable (VariableName, VendorGuid, Attributes, DataSize, Data);\r
196	}\r
197	\r
198	EFI_STATUS\r
199	EFIAPI\r
200	EfiGetNextVariableName (\r
201	IN OUT UINTN *VariableNameSize,\r
202	IN OUT CHAR16 *VariableName,\r
203	IN OUT EFI_GUID *VendorGuid\r
204	)\r
205	/*++\r
206	\r
207	Routine Description:\r
208	\r
209	Enumerates the current variable names.\r
210	\r
211	Arguments:\r
212	\r
213	VariableNameSize - The size of the VariableName buffer.\r
214	VariableName - On input, supplies the last VariableName that was returned\r
215	by GetNextVariableName().\r
216	On output, returns the Nullterminated Unicode string of the\r
217	current variable.\r
218	VendorGuid - On input, supplies the last VendorGuid that was returned by\r
219	GetNextVariableName().\r
220	On output, returns the VendorGuid of the current variable.\r
221	\r
222	Returns:\r
223	\r
224	Status code\r
225	\r
226	--*/\r
227	{\r
228	return mRT->GetNextVariableName (VariableNameSize, VariableName, VendorGuid);\r
229	}\r
230	\r
231	EFI_STATUS\r
232	EFIAPI\r
233	EfiSetVariable (\r
234	IN CHAR16 *VariableName,\r
235	IN EFI_GUID *VendorGuid,\r
236	IN UINT32 Attributes,\r
237	IN UINTN DataSize,\r
238	IN VOID *Data\r
239	)\r
240	/*++\r
241	\r
242	Routine Description:\r
243	\r
244	Sets the value of a variable.\r
245	\r
246	Arguments:\r
247	\r
248	VariableName - A Null-terminated Unicode string that is the name of the\r
249	vendor's variable.\r
250	VendorGuid - A unique identifier for the vendor.\r
251	Attributes - Attributes bitmask to set for the variable.\r
252	DataSize - The size in bytes of the Data buffer.\r
253	Data - The contents for the variable.\r
254	\r
255	Returns:\r
256	\r
257	Status code\r
258	\r
259	--*/\r
260	{\r
261	return mRT->SetVariable (VariableName, VendorGuid, Attributes, DataSize, Data);\r
262	}\r
263	\r
264	EFI_STATUS\r
265	EFIAPI\r
266	EfiGetNextHighMonotonicCount (\r
267	OUT UINT32 *HighCount\r
268	)\r
269	/*++\r
270	\r
271	Routine Description:\r
272	\r
273	Returns the next high 32 bits of the platform's monotonic counter.\r
274	\r
275	Arguments:\r
276	\r
277	HighCount - Pointer to returned value.\r
278	\r
279	Returns:\r
280	\r
281	Status code\r
282	\r
283	--*/\r
284	{\r
285	return mRT->GetNextHighMonotonicCount (HighCount);\r
286	}\r
287	\r
288	EFI_STATUS\r
289	EFIAPI\r
290	EfiConvertPointer (\r
291	IN UINTN DebugDisposition,\r
292	IN OUT VOID **Address\r
293	)\r
294	/*++\r
295	\r
296	Routine Description:\r
297	\r
298	Determines the new virtual address that is to be used on subsequent memory accesses.\r
299	\r
300	Arguments:\r
301	\r
302	DebugDisposition - Supplies type information for the pointer being converted.\r
303	Address - A pointer to a pointer that is to be fixed to be the value needed\r
304	for the new virtual address mappings being applied.\r
305	\r
306	Returns:\r
307	\r
308	Status code\r
309	\r
310	--*/\r
311	{\r
312	return mRT->ConvertPointer (DebugDisposition, Address);\r
313	}\r
314	\r
315	EFI_STATUS\r
316	EFIAPI\r
317	EfiConvertList (\r
318	IN UINTN DebugDisposition,\r
319	IN OUT LIST_ENTRY *ListHead\r
320	)\r
321	/*++\r
322	\r
323	Routine Description:\r
324	\r
325	Conver the standard Lib double linked list to a virtual mapping.\r
326	\r
327	Arguments:\r
328	\r
329	DebugDisposition - Argument to EfiConvertPointer (EFI 1.0 API)\r
330	\r
331	ListHead - Head of linked list to convert\r
332	\r
333	Returns:\r
334	\r
335	EFI_SUCCESS\r
336	\r
337	--*/\r
338	{\r
339	LIST_ENTRY *Link;\r
340	LIST_ENTRY *NextLink;\r
341	\r
342	//\r
343	// Convert all the ForwardLink & BackLink pointers in the list\r
344	//\r
345	Link = ListHead;\r
346	do {\r
347	NextLink = Link->ForwardLink;\r
348	\r
349	EfiConvertPointer (\r
350	Link->ForwardLink == ListHead ? DebugDisposition : 0,\r
351	(VOID **) &Link->ForwardLink\r
352	);\r
353	\r
354	EfiConvertPointer (\r
355	Link->BackLink == ListHead ? DebugDisposition : 0,\r
356	(VOID **) &Link->BackLink\r
357	);\r
358	\r
359	Link = NextLink;\r
360	} while (Link != ListHead);\r
361	return EFI_SUCCESS;\r
362	}\r
363	\r
364	\r
365	/**\r
366	Change the runtime addressing mode of EFI firmware from physical to virtual.\r
367	\r
368	@param MemoryMapSize The size in bytes of VirtualMap.\r
369	@param DescriptorSize The size in bytes of an entry in the VirtualMap.\r
370	@param DescriptorVersion The version of the structure entries in VirtualMap.\r
371	@param VirtualMap An array of memory descriptors which contain new virtual\r
372	address mapping information for all runtime ranges. Type\r
373	EFI_MEMORY_DESCRIPTOR is defined in the\r
374	GetMemoryMap() function description.\r
375	\r
376	@retval EFI_SUCCESS The virtual address map has been applied.\r
377	@retval EFI_UNSUPPORTED EFI firmware is not at runtime, or the EFI firmware is already in\r
378	virtual address mapped mode.\r
379	@retval EFI_INVALID_PARAMETER DescriptorSize or DescriptorVersion is\r
380	invalid.\r
381	@retval EFI_NO_MAPPING A virtual address was not supplied for a range in the memory\r
382	map that requires a mapping.\r
383	@retval EFI_NOT_FOUND A virtual address was supplied for an address that is not found\r
384	in the memory map.\r
385	**/\r
386	EFI_STATUS\r
387	EFIAPI\r
388	EfiSetVirtualAddressMap (\r
389	IN UINTN MemoryMapSize,\r
390	IN UINTN DescriptorSize,\r
391	IN UINT32 DescriptorVersion,\r
392	IN CONST EFI_MEMORY_DESCRIPTOR *VirtualMap\r
393	)\r
394	{\r
395	return mRT->SetVirtualAddressMap (\r
396	MemoryMapSize,\r
397	DescriptorSize,\r
398	DescriptorVersion,\r
399	(EFI_MEMORY_DESCRIPTOR *) VirtualMap\r
400	);\r
401	}\r
402	\r
403	\r
404	EFI_STATUS\r
405	EFIAPI\r
406	EfiUpdateCapsule (\r
b67d6130	407	IN EFI_CAPSULE_HEADER **CapsuleHeaderArray,\r
	408	IN UINTN CapsuleCount,\r
	409	IN EFI_PHYSICAL_ADDRESS ScatterGatherList OPTIONAL\r
ebcc8fb7	410	)\r
	411	{\r
	412	return mRT->UpdateCapsule (\r
	413	CapsuleHeaderArray,\r
	414	CapsuleCount,\r
	415	ScatterGatherList\r
	416	);\r
	417	}\r
	418	\r
	419	EFI_STATUS\r
	420	EFIAPI\r
	421	EfiQueryCapsuleCapabilities (\r
b67d6130	422	IN EFI_CAPSULE_HEADER **CapsuleHeaderArray,\r
	423	IN UINTN CapsuleCount,\r
	424	OUT UINT64 *MaximumCapsuleSize,\r
	425	OUT EFI_RESET_TYPE *ResetType\r
ebcc8fb7	426	)\r
	427	{\r
	428	return mRT->QueryCapsuleCapabilities (\r
	429	CapsuleHeaderArray,\r
	430	CapsuleCount,\r
	431	MaximumCapsuleSize,\r
	432	ResetType\r
	433	);\r
	434	}\r
	435	\r
	436	\r
	437	EFI_STATUS\r
	438	EFIAPI\r
	439	EfiQueryVariableInfo (\r
b67d6130	440	IN UINT32 Attributes,\r
	441	OUT UINT64 *MaximumVariableStorageSize,\r
	442	OUT UINT64 *RemainingVariableStorageSize,\r
	443	OUT UINT64 *MaximumVariableSize\r
ebcc8fb7	444	)\r
	445	{\r
	446	return mRT->QueryVariableInfo (\r
	447	Attributes,\r
	448	MaximumVariableStorageSize,\r
	449	RemainingVariableStorageSize,\r
	450	MaximumVariableSize\r
	451	);\r
	452	}\r