3 Copyright (c) 2004 - 2006, Intel Corporation
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
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.
23 #include "..\RuntimeLibInternal.h"
28 IN EFI_RESET_TYPE ResetType
,
29 IN EFI_STATUS ResetStatus
,
37 Resets the entire platform.
41 ResetType - The type of reset to perform.
42 ResetStatus - The status code for the reset.
43 DataSize - The size, in bytes, of ResetData.
44 ResetData - A data buffer that includes a Null-terminated Unicode string, optionally
45 followed by additional binary data.
53 mRT
->ResetSystem (ResetType
, ResetStatus
, DataSize
, ResetData
);
57 // The following functions hide the mRT local global from the call to
58 // runtime service in the EFI system table.
64 OUT EFI_TIME_CAPABILITIES
*Capabilities
70 Returns the current time and date information, and the time-keeping
71 capabilities of the hardware platform.
75 Time - A pointer to storage to receive a snapshot of the current time.
76 Capabilities - An optional pointer to a buffer to receive the real time clock device's
85 return mRT
->GetTime (Time
, Capabilities
);
97 Sets the current local time and date information.
101 Time - A pointer to the current time.
109 return mRT
->SetTime (Time
);
115 OUT BOOLEAN
*Enabled
,
116 OUT BOOLEAN
*Pending
,
123 Returns the current wakeup alarm clock setting.
127 Enabled - Indicates if the alarm is currently enabled or disabled.
128 Pending - Indicates if the alarm signal is pending and requires acknowledgement.
129 Time - The current alarm setting.
137 return mRT
->GetWakeupTime (Enabled
, Pending
, Time
);
150 Sets the system wakeup alarm clock time.
154 Enable - Enable or disable the wakeup alarm.
155 Time - If Enable is TRUE, the time to set the wakeup alarm for.
156 If Enable is FALSE, then this parameter is optional, and may be NULL.
164 return mRT
->SetWakeupTime (Enable
, Time
);
173 IN CHAR16
*VariableName
,
174 IN EFI_GUID
* VendorGuid
,
175 OUT UINT32
*Attributes OPTIONAL
,
176 IN OUT UINTN
*DataSize
,
183 Returns the value of a variable.
187 VariableName - A Null-terminated Unicode string that is the name of the
189 VendorGuid - A unique identifier for the vendor.
190 Attributes - If not NULL, a pointer to the memory location to return the
191 attributes bitmask for the variable.
192 DataSize - On input, the size in bytes of the return Data buffer.
193 On output the size of data returned in Data.
194 Data - The buffer to return the contents of the variable.
202 return mRT
->GetVariable (VariableName
, VendorGuid
, Attributes
, DataSize
, Data
);
207 EfiGetNextVariableName (
208 IN OUT UINTN
*VariableNameSize
,
209 IN OUT CHAR16
*VariableName
,
210 IN OUT EFI_GUID
*VendorGuid
216 Enumerates the current variable names.
220 VariableNameSize - The size of the VariableName buffer.
221 VariableName - On input, supplies the last VariableName that was returned
222 by GetNextVariableName().
223 On output, returns the Nullterminated Unicode string of the
225 VendorGuid - On input, supplies the last VendorGuid that was returned by
226 GetNextVariableName().
227 On output, returns the VendorGuid of the current variable.
235 return mRT
->GetNextVariableName (VariableNameSize
, VariableName
, VendorGuid
);
241 IN CHAR16
*VariableName
,
242 IN EFI_GUID
*VendorGuid
,
243 IN UINT32 Attributes
,
251 Sets the value of a variable.
255 VariableName - A Null-terminated Unicode string that is the name of the
257 VendorGuid - A unique identifier for the vendor.
258 Attributes - Attributes bitmask to set for the variable.
259 DataSize - The size in bytes of the Data buffer.
260 Data - The contents for the variable.
268 return mRT
->SetVariable (VariableName
, VendorGuid
, Attributes
, DataSize
, Data
);
273 EfiGetNextHighMonotonicCount (
274 OUT UINT32
*HighCount
280 Returns the next high 32 bits of the platform's monotonic counter.
284 HighCount - Pointer to returned value.
292 return mRT
->GetNextHighMonotonicCount (HighCount
);
298 IN UINTN DebugDisposition
,
299 IN OUT VOID
**Address
305 Determines the new virtual address that is to be used on subsequent memory accesses.
309 DebugDisposition - Supplies type information for the pointer being converted.
310 Address - A pointer to a pointer that is to be fixed to be the value needed
311 for the new virtual address mappings being applied.
319 return mRT
->ConvertPointer (DebugDisposition
, Address
);
325 IN UINTN DebugDisposition
,
326 IN OUT LIST_ENTRY
*ListHead
332 Conver the standard Lib double linked list to a virtual mapping.
336 DebugDisposition - Argument to EfiConvertPointer (EFI 1.0 API)
338 ListHead - Head of linked list to convert
347 LIST_ENTRY
*NextLink
;
350 // Convert all the ForwardLink & BackLink pointers in the list
354 NextLink
= Link
->ForwardLink
;
357 Link
->ForwardLink
== ListHead
? DebugDisposition
: 0,
358 (VOID
**) &Link
->ForwardLink
362 Link
->BackLink
== ListHead
? DebugDisposition
: 0,
363 (VOID
**) &Link
->BackLink
367 } while (Link
!= ListHead
);
373 Change the runtime addressing mode of EFI firmware from physical to virtual.
375 @param MemoryMapSize The size in bytes of VirtualMap.
376 @param DescriptorSize The size in bytes of an entry in the VirtualMap.
377 @param DescriptorVersion The version of the structure entries in VirtualMap.
378 @param VirtualMap An array of memory descriptors which contain new virtual
379 address mapping information for all runtime ranges. Type
380 EFI_MEMORY_DESCRIPTOR is defined in the
381 GetMemoryMap() function description.
383 @retval EFI_SUCCESS The virtual address map has been applied.
384 @retval EFI_UNSUPPORTED EFI firmware is not at runtime, or the EFI firmware is already in
385 virtual address mapped mode.
386 @retval EFI_INVALID_PARAMETER DescriptorSize or DescriptorVersion is
388 @retval EFI_NO_MAPPING A virtual address was not supplied for a range in the memory
389 map that requires a mapping.
390 @retval EFI_NOT_FOUND A virtual address was supplied for an address that is not found
395 EfiSetVirtualAddressMap (
396 IN UINTN MemoryMapSize
,
397 IN UINTN DescriptorSize
,
398 IN UINT32 DescriptorVersion
,
399 IN CONST EFI_MEMORY_DESCRIPTOR
*VirtualMap
402 return mRT
->SetVirtualAddressMap (
406 (EFI_MEMORY_DESCRIPTOR
*) VirtualMap
414 IN UEFI_CAPSULE_HEADER
**CapsuleHeaderArray
,
415 IN UINTN CapsuleCount
,
416 IN EFI_PHYSICAL_ADDRESS ScatterGatherList OPTIONAL
419 #if (EFI_SPECIFICATION_VERSION >= 0x00020000)
420 return mRT
->UpdateCapsule (
426 return EFI_UNSUPPORTED
;
432 EfiQueryCapsuleCapabilities (
433 IN UEFI_CAPSULE_HEADER
**CapsuleHeaderArray
,
434 IN UINTN CapsuleCount
,
435 OUT UINT64
*MaximumCapsuleSize
,
436 OUT EFI_RESET_TYPE
*ResetType
439 #if (EFI_SPECIFICATION_VERSION >= 0x00020000)
440 return mRT
->QueryCapsuleCapabilities (
447 return EFI_UNSUPPORTED
;
454 EfiQueryVariableInfo (
455 IN UINT32 Attributes
,
456 OUT UINT64
*MaximumVariableStorageSize
,
457 OUT UINT64
*RemainingVariableStorageSize
,
458 OUT UINT64
*MaximumVariableSize
461 #if (EFI_SPECIFICATION_VERSION >= 0x00020000)
462 return mRT
->QueryVariableInfo (
464 MaximumVariableStorageSize
,
465 RemainingVariableStorageSize
,
469 return EFI_UNSUPPORTED
;