1. Updated function headers in all assembly files.

[mirror_edk2.git] / EdkModulePkg / Library / EdkRuntimeStatusCodeLib / BsDataHubStatusCode / BsDataHubStatusCode.h

/*++\r
\r
Copyright (c) 2006, 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
Module Name:\r
\r
  BsDataHubStatusCode.h\r
\r
Abstract:\r
\r
  Header for the status code data hub logging component\r
\r
--*/\r
\r
#ifndef _EFI_BS_DATA_HUB_STATUS_CODE_H_\r
#define _EFI_BS_DATA_HUB_STATUS_CODE_H_\r
\r
//\r
// Private data declarations\r
//\r
#define MAX_RECORD_NUM                    1000\r
#define BYTES_PER_RECORD                  EFI_STATUS_CODE_DATA_MAX_SIZE\r
#define EMPTY_RECORD_TAG                  0xFF\r
\r
#define BS_DATA_HUB_STATUS_CODE_SIGNATURE EFI_SIGNATURE_32 ('B', 'D', 'H', 'S')\r
\r
typedef struct {\r
  UINTN           Signature;\r
  LIST_ENTRY      Link;\r
  UINT8           RecordBuffer[BYTES_PER_RECORD];\r
} STATUS_CODE_RECORD_LIST;\r
\r
//\r
// Function prototypes\r
//\r
STATUS_CODE_RECORD_LIST           *\r
GetRecordBuffer (\r
  VOID\r
  )\r
;\r
\r
/*++\r
\r
Routine Description:\r
\r
  Returned buffer of length BYTES_PER_RECORD\r
\r
Arguments:\r
\r
  None\r
\r
Returns:\r
\r
  Entry in mRecordBuffer or NULL if non available\r
\r
--*/\r
DATA_HUB_STATUS_CODE_DATA_RECORD  *\r
AquireEmptyRecordBuffer (\r
  VOID\r
  )\r
;\r
\r
/*++\r
\r
Routine Description:\r
\r
  Allocate a mRecordBuffer entry in the form of a pointer.\r
\r
Arguments:\r
\r
  None\r
\r
Returns:\r
\r
  Pointer to new buffer. NULL if none exist.\r
\r
--*/\r
EFI_STATUS\r
ReleaseRecordBuffer (\r
  IN  STATUS_CODE_RECORD_LIST  *RecordBuffer\r
  )\r
;\r
\r
/*++\r
\r
Routine Description:\r
\r
  Release a mRecordBuffer entry allocated by AquireEmptyRecordBuffer ().\r
\r
Arguments:\r
\r
  RecordBuffer          - Data to free\r
\r
Returns:\r
\r
  EFI_SUCCESS           - If RecordBuffer is valid\r
  EFI_UNSUPPORTED       - The record list has empty\r
\r
--*/\r
VOID\r
EFIAPI\r
LogDataHubEventHandler (\r
  IN  EFI_EVENT   Event,\r
  IN  VOID        *Context\r
  )\r
;\r
\r
/*++\r
\r
Routine Description:\r
\r
  Event Handler that log in Status code in Data Hub.\r
\r
Arguments:\r
\r
  (Standard EFI Event Handler - EFI_EVENT_NOTIFY)\r
\r
Returns:\r
\r
  NONE\r
\r
--*/\r
#endif\r