beautypg.com

5 efi driver diagnostics protocol, Efi_driver_diagnostics_protocol, Driver_diagnostics – Intel Extensible Firmware Interface User Manual

Page 285: Driver diagnostics protocol

background image

Protocols

— EFI Driver Model

Version 1.10

12/01/02

9-43

9.5 EFI Driver Diagnostics Protocol

This section provides a detailed description of the

EFI_DRIVER_DIAGNOSTICS_PROTOCOL

.

This is a protocol that allows an EFI Driver to perform diagnostics on a controller that the driver is
managing.

EFI_DRIVER_DIAGNOSTICS_PROTOCOL

Summary

Used to perform diagnostics on a controller that an EFI Driver is managing.

GUID

#define EFI_DRIVER_DIAGNOSTICS_PROTOCOL_GUID \

{ 0x0784924f,0xe296,0x11d4,0x9a,0x49,0x0,0x90,0x27,0x3f,0xc1,0x4d }

Protocol Interface Structure

typedef struct _EFI_DRIVER_DIAGNOSTICS_PROTOCOL {
EFI_DRIVER_DIAGNOSTICS_RUN_DIAGNOSTICS

RunDiagnostics;

CHAR8

*SupportedLanguages;

} EFI_DRIVER_DIAGNOSTICS_PROTOCOL;

Parameters

RunDiagnostics

Runs diagnostics on a controller. See the

RunDiagnostics()

function description.

SupportedLanguages

A Null-terminated ASCII string that contains one or more
ISO 639-2 language codes. This is the list of language codes
that this protocol supports.

Description

The

EFI_DRIVER_DIAGNOSTICS_PROTOCOL

is used by a platform management utility to

allow the user to run driver specific diagnostics on a controller. This protocol is optionally attached
to the image handle of driver in the driver’s entry point. The platform management utility can
collect all the

EFI_DRIVER_DISAGNOTICS_PROTOCOL

instances present in the system, and

present the user with a menu of the controllers that have diagnostic capabilities. This platform
management utility is invoked through a platform component such as the EFI Boot Manager.