[mirror_edk2.git] / MdePkg / Include / Uefi / UefiBaseType.h

/** @file\r
  Defines data types and constants introduced in UEFI.\r
\r
  Copyright (c) 2006 - 2008, 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
#ifndef __UEFI_BASETYPE_H__\r
#define __UEFI_BASETYPE_H__\r
\r
#include <Base.h>\r
\r
//\r
// Basic data type definitions introduced in UEFI.\r
//\r
\r
///\r
/// 128-bit buffer containing a unique identifier value.\r
///\r
typedef GUID                      EFI_GUID;\r
///\r
/// Function return status for EFI API\r
///\r
typedef RETURN_STATUS             EFI_STATUS;\r
///\r
/// A collection of related interfaces.\r
///\r
typedef VOID                      *EFI_HANDLE;\r
///\r
/// Handle to an event structure.\r
///\r
typedef VOID                      *EFI_EVENT;\r
///\r
/// Task priority level.\r
///\r
typedef UINTN                     EFI_TPL;\r
///\r
/// Logical block address.\r
///\r
typedef UINT64                    EFI_LBA;\r
\r
///\r
/// 64-bit physical memory address.\r
///\r
typedef UINT64                    EFI_PHYSICAL_ADDRESS;\r
\r
///\r
/// 64-bit virtual memory address.\r
///\r
typedef UINT64                    EFI_VIRTUAL_ADDRESS;\r
\r
///\r
/// EFI Time Abstraction:\r
///  Year:       1998 - 20XX\r
///  Month:      1 - 12\r
///  Day:        1 - 31\r
///  Hour:       0 - 23\r
///  Minute:     0 - 59\r
///  Second:     0 - 59\r
///  Nanosecond: 0 - 999,999,999\r
///  TimeZone:   -1440 to 1440 or 2047\r
///\r
typedef struct {\r
  UINT16  Year;\r
  UINT8   Month;\r
  UINT8   Day;\r
  UINT8   Hour;\r
  UINT8   Minute;\r
  UINT8   Second;\r
  UINT8   Pad1;\r
  UINT32  Nanosecond;\r
  INT16   TimeZone;\r
  UINT8   Daylight;\r
  UINT8   Pad2;\r
} EFI_TIME;\r
\r
\r
///\r
/// 4-byte buffer. An IPv4 internet protocol address.\r
///\r
typedef struct {\r
  UINT8 Addr[4];\r
} EFI_IPv4_ADDRESS;\r
\r
///\r
/// 16-byte buffer. An IPv6 internet protocol address\r
///\r
typedef struct {\r
  UINT8 Addr[16];\r
} EFI_IPv6_ADDRESS;\r
\r
///\r
/// 32-byte buffer containing a network Media Access Control address.\r
///\r
typedef struct {\r
  UINT8 Addr[32];\r
} EFI_MAC_ADDRESS;\r
\r
///\r
/// 16-byte buffer aligned on a 4-byte boundary.\r
/// An IPv4 or IPv6 internet protocol address.\r
///\r
typedef union {\r
  UINT32            Addr[4];\r
  EFI_IPv4_ADDRESS  v4;\r
  EFI_IPv6_ADDRESS  v6;\r
} EFI_IP_ADDRESS;\r
\r
\r
//\r
// Enumeration of EFI_STATUS.\r
// \r
#define EFI_SUCCESS               RETURN_SUCCESS              \r
#define EFI_LOAD_ERROR            RETURN_LOAD_ERROR           \r
#define EFI_INVALID_PARAMETER     RETURN_INVALID_PARAMETER    \r
#define EFI_UNSUPPORTED           RETURN_UNSUPPORTED          \r
#define EFI_BAD_BUFFER_SIZE       RETURN_BAD_BUFFER_SIZE      \r
#define EFI_BUFFER_TOO_SMALL      RETURN_BUFFER_TOO_SMALL     \r
#define EFI_NOT_READY             RETURN_NOT_READY            \r
#define EFI_DEVICE_ERROR          RETURN_DEVICE_ERROR         \r
#define EFI_WRITE_PROTECTED       RETURN_WRITE_PROTECTED      \r
#define EFI_OUT_OF_RESOURCES      RETURN_OUT_OF_RESOURCES     \r
#define EFI_VOLUME_CORRUPTED      RETURN_VOLUME_CORRUPTED     \r
#define EFI_VOLUME_FULL           RETURN_VOLUME_FULL          \r
#define EFI_NO_MEDIA              RETURN_NO_MEDIA             \r
#define EFI_MEDIA_CHANGED         RETURN_MEDIA_CHANGED        \r
#define EFI_NOT_FOUND             RETURN_NOT_FOUND            \r
#define EFI_ACCESS_DENIED         RETURN_ACCESS_DENIED        \r
#define EFI_NO_RESPONSE           RETURN_NO_RESPONSE          \r
#define EFI_NO_MAPPING            RETURN_NO_MAPPING           \r
#define EFI_TIMEOUT               RETURN_TIMEOUT              \r
#define EFI_NOT_STARTED           RETURN_NOT_STARTED          \r
#define EFI_ALREADY_STARTED       RETURN_ALREADY_STARTED      \r
#define EFI_ABORTED               RETURN_ABORTED              \r
#define EFI_ICMP_ERROR            RETURN_ICMP_ERROR           \r
#define EFI_TFTP_ERROR            RETURN_TFTP_ERROR           \r
#define EFI_PROTOCOL_ERROR        RETURN_PROTOCOL_ERROR       \r
#define EFI_INCOMPATIBLE_VERSION  RETURN_INCOMPATIBLE_VERSION \r
#define EFI_SECURITY_VIOLATION    RETURN_SECURITY_VIOLATION   \r
#define EFI_CRC_ERROR             RETURN_CRC_ERROR   \r
#define EFI_END_OF_MEDIA          RETURN_END_OF_MEDIA\r
#define EFI_END_OF_FILE           RETURN_END_OF_FILE\r
#define EFI_INVALID_LANGUAGE      RETURN_INVALID_LANGUAGE\r
\r
#define EFI_WARN_UNKNOWN_GLYPH    RETURN_WARN_UNKNOWN_GLYPH   \r
#define EFI_WARN_DELETE_FAILURE   RETURN_WARN_DELETE_FAILURE  \r
#define EFI_WARN_WRITE_FAILURE    RETURN_WARN_WRITE_FAILURE   \r
#define EFI_WARN_BUFFER_TOO_SMALL RETURN_WARN_BUFFER_TOO_SMALL\r
\r
\r
//\r
// Define macro to encode the status code.\r
// \r
#define EFIERR(_a)                ENCODE_ERROR(_a)\r
\r
#define EFI_ERROR(A)              RETURN_ERROR(A)\r
\r
\r
\r
//\r
// The EFI memory allocation functions work in units of EFI_PAGEs that are\r
// 4K. This should in no way be confused with the page size of the processor.\r
// An EFI_PAGE is just the quanta of memory in EFI.\r
//\r
#define EFI_PAGE_SIZE             0x1000\r
#define EFI_PAGE_MASK             0xFFF\r
#define EFI_PAGE_SHIFT            12\r
\r
#define EFI_SIZE_TO_PAGES(a)  (((a) >> EFI_PAGE_SHIFT) + (((a) & EFI_PAGE_MASK) ? 1 : 0))\r
\r
#define EFI_PAGES_TO_SIZE(a)   ( (a) << EFI_PAGE_SHIFT)\r
\r
///\r
/// PE32+ Machine type for IA32 UEFI images\r
///\r
#define EFI_IMAGE_MACHINE_IA32      0x014C\r
\r
///\r
/// PE32+ Machine type for IA64 UEFI images\r
///\r
#define EFI_IMAGE_MACHINE_IA64      0x0200\r
\r
///\r
/// PE32+ Machine type for EBC UEFI images\r
///\r
#define EFI_IMAGE_MACHINE_EBC       0x0EBC\r
\r
///\r
/// PE32+ Machine type for X64 UEFI images\r
///\r
#define EFI_IMAGE_MACHINE_X64       0x8664\r
\r
\r
#if   defined (MDE_CPU_IA32)\r
\r
#define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) \\r
  (((Machine) == EFI_IMAGE_MACHINE_IA32) || ((Machine) == EFI_IMAGE_MACHINE_EBC))\r
\r
#define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) ((Machine) == EFI_IMAGE_MACHINE_X64) \r
\r
#elif defined (MDE_CPU_IPF)\r
\r
#define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) \\r
  (((Machine) == EFI_IMAGE_MACHINE_IA64) || ((Machine) == EFI_IMAGE_MACHINE_EBC))\r
\r
#define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) (FALSE) \r
\r
#elif defined (MDE_CPU_X64)\r
\r
#define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) \\r
  (((Machine) == EFI_IMAGE_MACHINE_X64) || ((Machine) == EFI_IMAGE_MACHINE_EBC))\r
\r
#define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) ((Machine) == EFI_IMAGE_MACHINE_IA32) \r
\r
#elif defined (MDE_CPU_EBC)\r
\r
///\r
/// This is just to make sure you can cross compile with the EBC compiler.\r
/// It does not make sense to have a PE loader coded in EBC. You need to \r
/// understand the basic.\r
///\r
#define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) ((Machine) == EFI_IMAGE_MACHINE_EBC)\r
\r
#define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) (FALSE) \r
\r
#else\r
#error Unknown Processor Type\r
#endif\r
\r
#endif\r
Commit	Line	Data
c311f86b	1	/** @file\r
959ccb23	2	Defines data types and constants introduced in UEFI.\r
959ccb23	3	\r
54cf8780	4	Copyright (c) 2006 - 2008, Intel Corporation\r
c311f86b	5	All rights reserved. This program and the accompanying materials\r
	6	are licensed and made available under the terms and conditions of the BSD License\r
	7	which accompanies this distribution. The full text of the license may be found at\r
	8	http://opensource.org/licenses/bsd-license.php\r
	9	\r
	10	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
	11	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
959ccb23	12	\r
	13	**/\r
	14	\r
	15	#ifndef __UEFI_BASETYPE_H__\r
	16	#define __UEFI_BASETYPE_H__\r
	17	\r
a0f1b047	18	#include <Base.h>\r
959ccb23	19	\r
e0c047a0	20	//\r
eaad1319	21	// Basic data type definitions introduced in UEFI.\r
e0c047a0	22	//\r
	23	\r
	24	///\r
	25	/// 128-bit buffer containing a unique identifier value.\r
8b13229b	26	///\r
00edb218	27	typedef GUID EFI_GUID;\r
3f748e52	28	///\r
	29	/// Function return status for EFI API\r
	30	///\r
00edb218	31	typedef RETURN_STATUS EFI_STATUS;\r
e0c047a0	32	///\r
	33	/// A collection of related interfaces.\r
	34	///\r
00edb218	35	typedef VOID *EFI_HANDLE;\r
e0c047a0	36	///\r
	37	/// Handle to an event structure.\r
	38	///\r
00edb218	39	typedef VOID *EFI_EVENT;\r
e0c047a0	40	///\r
	41	/// Task priority level.\r
	42	///\r
00edb218	43	typedef UINTN EFI_TPL;\r
e0c047a0	44	///\r
	45	/// Logical block address.\r
	46	///\r
00edb218	47	typedef UINT64 EFI_LBA;\r
6617fcc2	48	\r
	49	///\r
	50	/// 64-bit physical memory address.\r
	51	///\r
00edb218	52	typedef UINT64 EFI_PHYSICAL_ADDRESS;\r
6617fcc2	53	\r
	54	///\r
	55	/// 64-bit virtual memory address.\r
	56	///\r
00edb218	57	typedef UINT64 EFI_VIRTUAL_ADDRESS;\r
959ccb23	58	\r
fb5148a0	59	///\r
fb5148a0	60	/// EFI Time Abstraction:\r
e0c047a0	61	/// Year: 1998 - 20XX\r
fb5148a0	62	/// Month: 1 - 12\r
	63	/// Day: 1 - 31\r
	64	/// Hour: 0 - 23\r
	65	/// Minute: 0 - 59\r
	66	/// Second: 0 - 59\r
	67	/// Nanosecond: 0 - 999,999,999\r
	68	/// TimeZone: -1440 to 1440 or 2047\r
	69	///\r
959ccb23	70	typedef struct {\r
	71	UINT16 Year;\r
	72	UINT8 Month;\r
	73	UINT8 Day;\r
	74	UINT8 Hour;\r
	75	UINT8 Minute;\r
	76	UINT8 Second;\r
	77	UINT8 Pad1;\r
	78	UINT32 Nanosecond;\r
	79	INT16 TimeZone;\r
	80	UINT8 Daylight;\r
	81	UINT8 Pad2;\r
	82	} EFI_TIME;\r
	83	\r
d1f95000	84	\r
e0c047a0	85	///\r
	86	/// 4-byte buffer. An IPv4 internet protocol address.\r
	87	///\r
d1f95000	88	typedef struct {\r
	89	UINT8 Addr[4];\r
	90	} EFI_IPv4_ADDRESS;\r
	91	\r
e0c047a0	92	///\r
	93	/// 16-byte buffer. An IPv6 internet protocol address\r
	94	///\r
d1f95000	95	typedef struct {\r
	96	UINT8 Addr[16];\r
	97	} EFI_IPv6_ADDRESS;\r
	98	\r
e0c047a0	99	///\r
	100	/// 32-byte buffer containing a network Media Access Control address.\r
	101	///\r
d1f95000	102	typedef struct {\r
	103	UINT8 Addr[32];\r
	104	} EFI_MAC_ADDRESS;\r
	105	\r
e0c047a0	106	///\r
	107	/// 16-byte buffer aligned on a 4-byte boundary.\r
	108	/// An IPv4 or IPv6 internet protocol address.\r
	109	///\r
d1f95000	110	typedef union {\r
	111	UINT32 Addr[4];\r
	112	EFI_IPv4_ADDRESS v4;\r
	113	EFI_IPv6_ADDRESS v6;\r
	114	} EFI_IP_ADDRESS;\r
	115	\r
	116	\r
959ccb23	117	//\r
	118	// Enumeration of EFI_STATUS.\r
	119	// \r
	120	#define EFI_SUCCESS RETURN_SUCCESS \r
	121	#define EFI_LOAD_ERROR RETURN_LOAD_ERROR \r
	122	#define EFI_INVALID_PARAMETER RETURN_INVALID_PARAMETER \r
	123	#define EFI_UNSUPPORTED RETURN_UNSUPPORTED \r
	124	#define EFI_BAD_BUFFER_SIZE RETURN_BAD_BUFFER_SIZE \r
	125	#define EFI_BUFFER_TOO_SMALL RETURN_BUFFER_TOO_SMALL \r
	126	#define EFI_NOT_READY RETURN_NOT_READY \r
	127	#define EFI_DEVICE_ERROR RETURN_DEVICE_ERROR \r
	128	#define EFI_WRITE_PROTECTED RETURN_WRITE_PROTECTED \r
	129	#define EFI_OUT_OF_RESOURCES RETURN_OUT_OF_RESOURCES \r
	130	#define EFI_VOLUME_CORRUPTED RETURN_VOLUME_CORRUPTED \r
	131	#define EFI_VOLUME_FULL RETURN_VOLUME_FULL \r
	132	#define EFI_NO_MEDIA RETURN_NO_MEDIA \r
	133	#define EFI_MEDIA_CHANGED RETURN_MEDIA_CHANGED \r
	134	#define EFI_NOT_FOUND RETURN_NOT_FOUND \r
	135	#define EFI_ACCESS_DENIED RETURN_ACCESS_DENIED \r
	136	#define EFI_NO_RESPONSE RETURN_NO_RESPONSE \r
	137	#define EFI_NO_MAPPING RETURN_NO_MAPPING \r
	138	#define EFI_TIMEOUT RETURN_TIMEOUT \r
	139	#define EFI_NOT_STARTED RETURN_NOT_STARTED \r
	140	#define EFI_ALREADY_STARTED RETURN_ALREADY_STARTED \r
	141	#define EFI_ABORTED RETURN_ABORTED \r
	142	#define EFI_ICMP_ERROR RETURN_ICMP_ERROR \r
	143	#define EFI_TFTP_ERROR RETURN_TFTP_ERROR \r
	144	#define EFI_PROTOCOL_ERROR RETURN_PROTOCOL_ERROR \r
	145	#define EFI_INCOMPATIBLE_VERSION RETURN_INCOMPATIBLE_VERSION \r
	146	#define EFI_SECURITY_VIOLATION RETURN_SECURITY_VIOLATION \r
	147	#define EFI_CRC_ERROR RETURN_CRC_ERROR \r
	148	#define EFI_END_OF_MEDIA RETURN_END_OF_MEDIA\r
	149	#define EFI_END_OF_FILE RETURN_END_OF_FILE\r
54cf8780	150	#define EFI_INVALID_LANGUAGE RETURN_INVALID_LANGUAGE\r
959ccb23	151	\r
	152	#define EFI_WARN_UNKNOWN_GLYPH RETURN_WARN_UNKNOWN_GLYPH \r
	153	#define EFI_WARN_DELETE_FAILURE RETURN_WARN_DELETE_FAILURE \r
	154	#define EFI_WARN_WRITE_FAILURE RETURN_WARN_WRITE_FAILURE \r
	155	#define EFI_WARN_BUFFER_TOO_SMALL RETURN_WARN_BUFFER_TOO_SMALL\r
	156	\r
	157	\r
959ccb23	158	//\r
	159	// Define macro to encode the status code.\r
	160	// \r
00edb218	161	#define EFIERR(_a) ENCODE_ERROR(_a)\r
959ccb23	162	\r
	163	#define EFI_ERROR(A) RETURN_ERROR(A)\r
	164	\r
959ccb23	165	\r
959ccb23	166	\r
	167	//\r
	168	// The EFI memory allocation functions work in units of EFI_PAGEs that are\r
	169	// 4K. This should in no way be confused with the page size of the processor.\r
	170	// An EFI_PAGE is just the quanta of memory in EFI.\r
	171	//\r
00edb218 A	172	#define EFI_PAGE_SIZE 0x1000\r
	173	#define EFI_PAGE_MASK 0xFFF\r
	174	#define EFI_PAGE_SHIFT 12\r
959ccb23	175	\r
833bd94e	176	#define EFI_SIZE_TO_PAGES(a) (((a) >> EFI_PAGE_SHIFT) + (((a) & EFI_PAGE_MASK) ? 1 : 0))\r
	177	\r
	178	#define EFI_PAGES_TO_SIZE(a) ( (a) << EFI_PAGE_SHIFT)\r
959ccb23	179	\r
4ab0dff3	180	///\r
	181	/// PE32+ Machine type for IA32 UEFI images\r
	182	///\r
	183	#define EFI_IMAGE_MACHINE_IA32 0x014C\r
	184	\r
	185	///\r
	186	/// PE32+ Machine type for IA64 UEFI images\r
	187	///\r
	188	#define EFI_IMAGE_MACHINE_IA64 0x0200\r
	189	\r
	190	///\r
	191	/// PE32+ Machine type for EBC UEFI images\r
	192	///\r
	193	#define EFI_IMAGE_MACHINE_EBC 0x0EBC\r
	194	\r
	195	///\r
	196	/// PE32+ Machine type for X64 UEFI images\r
	197	///\r
	198	#define EFI_IMAGE_MACHINE_X64 0x8664\r
	199	\r
	200	\r
	201	#if defined (MDE_CPU_IA32)\r
	202	\r
	203	#define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) \\r
	204	(((Machine) == EFI_IMAGE_MACHINE_IA32) \|\| ((Machine) == EFI_IMAGE_MACHINE_EBC))\r
	205	\r
	206	#define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) ((Machine) == EFI_IMAGE_MACHINE_X64) \r
	207	\r
	208	#elif defined (MDE_CPU_IPF)\r
	209	\r
	210	#define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) \\r
	211	(((Machine) == EFI_IMAGE_MACHINE_IA64) \|\| ((Machine) == EFI_IMAGE_MACHINE_EBC))\r
	212	\r
	213	#define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) (FALSE) \r
	214	\r
	215	#elif defined (MDE_CPU_X64)\r
	216	\r
	217	#define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) \\r
	218	(((Machine) == EFI_IMAGE_MACHINE_X64) \|\| ((Machine) == EFI_IMAGE_MACHINE_EBC))\r
	219	\r
	220	#define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) ((Machine) == EFI_IMAGE_MACHINE_IA32) \r
	221	\r
	222	#elif defined (MDE_CPU_EBC)\r
	223	\r
	224	///\r
eaad1319	225	/// This is just to make sure you can cross compile with the EBC compiler.\r
4ab0dff3	226	/// It does not make sense to have a PE loader coded in EBC. You need to \r
f754f721	227	/// understand the basic.\r
4ab0dff3	228	///\r
	229	#define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) ((Machine) == EFI_IMAGE_MACHINE_EBC)\r
	230	\r
	231	#define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) (FALSE) \r
	232	\r
	233	#else\r
	234	#error Unknown Processor Type\r
	235	#endif\r
f4e8509b	236	\r
959ccb23	237	#endif\r