/** @file\r
-\r
-Copyright (c) 2007 - 2008, Intel Corporation \r
+ Support routines for PxeBc.\r
+Copyright (c) 2007 - 2008, Intel Corporation.<BR> \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
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
-Module Name:\r
+**/\r
\r
- PxeBcSupport.h\r
+#ifndef __EFI_PXEBC_SUPPORT_H__\r
+#define __EFI_PXEBC_SUPPORT_H__\r
\r
-Abstract:\r
+/**\r
+ This function gets system guid and serial number from the smbios table.\r
\r
- Support routines for PxeBc\r
+ @param SystemGuid The pointer of returned system guid.\r
+ @param SystemSerialNumber The pointer of returned system serial number.\r
\r
+ @retval EFI_SUCCESS Successfully get the system guid and system serial\r
+ number.\r
+ @retval EFI_NOT_FOUND Not find the SMBIOS table.\r
\r
**/\r
-\r
-#ifndef __EFI_PXEBC_SUPPORT_H__\r
-#define __EFI_PXEBC_SUPPORT_H__\r
-\r
EFI_STATUS\r
GetSmbiosSystemGuidAndSerialNumber (\r
IN EFI_GUID *SystemGuid,\r
\r
\r
/**\r
- GC_NOTO: Add function description\r
+ The common notify function associated with various PxeBc events. \r
\r
- @param Event GC_NOTO: add argument description\r
- @param Context GC_NOTO: add argument description\r
+ @param Event The event signaled.\r
+ @param Context The context.\r
\r
- @return GC_NOTO: add return values\r
+ @return None\r
\r
**/\r
VOID\r
PxeBcCommonNotify (\r
IN EFI_EVENT Event,\r
IN VOID *Context\r
- )\r
-;\r
+ );\r
\r
+\r
+/**\r
+ This function initialize(or configure) the Udp4Write instance.\r
+ \r
+ @param Udp4 Pointer to the EFI_UDP4_PROTOCOL instance.\r
+ @param StationIp Pointer to the station ip address.\r
+ @param SubnetMask Pointer to the subnetmask of the station ip address.\r
+ @param Gateway Pointer to the gateway ip address.\r
+ @param SrcPort Pointer to the srouce port of the station.\r
+ \r
+ @retval EFI_SUCCESS The configuration settings were set, changed, or reset successfully.\r
+ @retval EFI_NO_MAPPING When using a default address, configuration (DHCP, BOOTP,\r
+ RARP, etc.) is not finished yet.\r
+ @retval EFI_INVALID_PARAMETER One or more following conditions are TRUE:\r
+ @retval EFI_ALREADY_STARTED The EFI UDPv4 Protocol instance is already started/configured\r
+ and must be stopped/reset before it can be reconfigured.\r
+ @retval EFI_ACCESS_DENIED UdpConfigData. AllowDuplicatePort is FALSE\r
+ and UdpConfigData.StationPort is already used by\r
+ other instance.\r
+ @retval EFI_OUT_OF_RESOURCES The EFI UDPv4 Protocol driver cannot allocate memory for this\r
+ EFI UDPv4 Protocol instance.\r
+ @retval EFI_DEVICE_ERROR An unexpected network or system error occurred and this instance\r
+ was not opened.\r
+ @retval Others Please examine the function Udp4->Routes(Udp4, FALSE, &mZeroIp4Addr, &mZeroIp4Addr, Gateway) returns.\r
+ \r
+**/\r
EFI_STATUS\r
PxeBcConfigureUdpWriteInstance (\r
IN EFI_UDP4_PROTOCOL *Udp4,\r
IN EFI_IPv4_ADDRESS *Gateway,\r
IN OUT UINT16 *SrcPort\r
);\r
+/**\r
+ Convert number to ASCII value.\r
+\r
+ @param Number Numeric value to convert to decimal ASCII value.\r
+ @param Buffer Buffer to place ASCII version of the Number.\r
+ @param Length Length of Buffer.\r
+\r
+**/\r
VOID\r
CvtNum (\r
IN UINTN Number,\r
IN UINT8 *Buffer,\r
- IN INTN Length\r
+ IN UINTN Length\r
);\r
\r
\r
/**\r
- GC_NOTO: Add function description\r
+ Convert unsigned int number to decimal number.\r
\r
- @param Number GC_NOTO: add argument description\r
- @param BufferPtr GC_NOTO: add argument description\r
+ @param Number The unsigned int number will be converted.\r
+ @param Buffer Pointer to the buffer to store the decimal number after transform.\r
\r
- @return GC_NOTO: add return values\r
+ @return the length of the number after transform.\r
\r
**/\r
UINTN\r
UtoA10 (\r
- UINTN Number,\r
- CHAR8 *BufferPtr\r
- )\r
-;\r
+ IN UINTN Number,\r
+ IN CHAR8 *Buffer\r
+ );\r
\r
\r
/**\r
- GC_NOTO: Add function description\r
+ Convert ASCII numeric string to a UINTN value.\r
\r
- @param BufferPtr GC_NOTO: add argument description\r
+ @param Buffer Pointer to the 8-byte unsigned int value.\r
\r
- @return GC_NOTO: add return values\r
+ @return UINTN value of the ASCII string.\r
\r
**/\r
UINT64\r
AtoU64 (\r
- UINT8 *BufferPtr\r
- )\r
-;\r
+ IN UINT8 *Buffer\r
+ );\r
\r
\r
#endif\r