mirror of https://github.com/acidanthera/audk.git
106 lines
5.5 KiB
C
106 lines
5.5 KiB
C
/** @file
|
|
UEFI Driver Diagnostics2 Protocol
|
|
|
|
Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#ifndef __EFI_DRIVER_DIAGNOSTICS2_H__
|
|
#define __EFI_DRIVER_DIAGNOSTICS2_H__
|
|
|
|
#include <Protocol/DriverDiagnostics.h>
|
|
|
|
#define EFI_DRIVER_DIAGNOSTICS2_PROTOCOL_GUID \
|
|
{ \
|
|
0x4d330321, 0x025f, 0x4aac, {0x90, 0xd8, 0x5e, 0xd9, 0x00, 0x17, 0x3b, 0x63 } \
|
|
}
|
|
|
|
typedef struct _EFI_DRIVER_DIAGNOSTICS2_PROTOCOL EFI_DRIVER_DIAGNOSTICS2_PROTOCOL;
|
|
|
|
/**
|
|
Runs diagnostics on a controller.
|
|
|
|
@param This A pointer to the EFI_DRIVER_DIAGNOSTICS2_PROTOCOL instance.
|
|
@param ControllerHandle The handle of the controller to run diagnostics on.
|
|
@param ChildHandle The handle of the child controller to run diagnostics on
|
|
This is an optional parameter that may be NULL. It will
|
|
be NULL for device drivers. It will also be NULL for
|
|
bus drivers that wish to run diagnostics on the bus
|
|
controller. It will not be NULL for a bus driver that
|
|
wishes to run diagnostics on one of its child controllers.
|
|
@param DiagnosticType Indicates the type of diagnostics to perform on the controller
|
|
specified by ControllerHandle and ChildHandle. See
|
|
"Related Definitions" for the list of supported types.
|
|
@param Language A pointer to a Null-terminated ASCII string
|
|
array indicating the language. This is the
|
|
language of the driver name that the caller
|
|
is requesting, and it must match one of the
|
|
languages specified in SupportedLanguages.
|
|
The number of languages supported by a
|
|
driver is up to the driver writer. Language
|
|
is specified in RFC 4646 language code format.
|
|
@param ErrorType A GUID that defines the format of the data returned in Buffer.
|
|
@param BufferSize The size, in bytes, of the data returned in Buffer.
|
|
@param Buffer A buffer that contains a Null-terminated Unicode string
|
|
plus some additional data whose format is defined by
|
|
ErrorType. Buffer is allocated by this function with
|
|
AllocatePool(), and it is the caller's responsibility
|
|
to free it with a call to FreePool().
|
|
|
|
@retval EFI_SUCCESS The controller specified by ControllerHandle and
|
|
ChildHandle passed the diagnostic.
|
|
@retval EFI_ACCESS_DENIED The request for initiating diagnostics was unable
|
|
to be complete due to some underlying hardware or
|
|
software state.
|
|
@retval EFI_INVALID_PARAMETER ControllerHandle is NULL.
|
|
@retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid EFI_HANDLE.
|
|
@retval EFI_INVALID_PARAMETER Language is NULL.
|
|
@retval EFI_INVALID_PARAMETER ErrorType is NULL.
|
|
@retval EFI_INVALID_PARAMETER BufferType is NULL.
|
|
@retval EFI_INVALID_PARAMETER Buffer is NULL.
|
|
@retval EFI_UNSUPPORTED The driver specified by This does not support
|
|
running diagnostics for the controller specified
|
|
by ControllerHandle and ChildHandle.
|
|
@retval EFI_UNSUPPORTED The driver specified by This does not support the
|
|
type of diagnostic specified by DiagnosticType.
|
|
@retval EFI_UNSUPPORTED The driver specified by This does not support the
|
|
language specified by Language.
|
|
@retval EFI_OUT_OF_RESOURCES There are not enough resources available to complete
|
|
the diagnostics.
|
|
@retval EFI_OUT_OF_RESOURCES There are not enough resources available to return
|
|
the status information in ErrorType, BufferSize,
|
|
and Buffer.
|
|
@retval EFI_DEVICE_ERROR The controller specified by ControllerHandle and
|
|
ChildHandle did not pass the diagnostic.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_DRIVER_DIAGNOSTICS2_RUN_DIAGNOSTICS)(
|
|
IN EFI_DRIVER_DIAGNOSTICS2_PROTOCOL *This,
|
|
IN EFI_HANDLE ControllerHandle,
|
|
IN EFI_HANDLE ChildHandle OPTIONAL,
|
|
IN EFI_DRIVER_DIAGNOSTIC_TYPE DiagnosticType,
|
|
IN CHAR8 *Language,
|
|
OUT EFI_GUID **ErrorType,
|
|
OUT UINTN *BufferSize,
|
|
OUT CHAR16 **Buffer
|
|
);
|
|
|
|
///
|
|
/// Used to perform diagnostics on a controller that an EFI Driver is managing.
|
|
///
|
|
struct _EFI_DRIVER_DIAGNOSTICS2_PROTOCOL {
|
|
EFI_DRIVER_DIAGNOSTICS2_RUN_DIAGNOSTICS RunDiagnostics;
|
|
///
|
|
/// A Null-terminated ASCII string that contains one or more RFC 4646
|
|
/// language codes. This is the list of language codes that this protocol supports.
|
|
///
|
|
CHAR8 *SupportedLanguages;
|
|
};
|
|
|
|
extern EFI_GUID gEfiDriverDiagnostics2ProtocolGuid;
|
|
|
|
#endif
|