Intel Extensible Firmware Interface User Manual

Page 689

Advertising
background image

Protocols

— Network Support

Version 1.10

12/01/02

15-83

AlgorithmID

A predefined constant representing a particular digital signature
algorithm. Often this represents a combination of hash algorithm and
encryption algorithm, however, it may also represent a standalone digital
signature algorithm. Type

BIS_ALG_ID

and its permitted values are

defined in “Related Definitions” below.

KeyLength

The length of the public key, in bits, supported by this digital signature
algorithm.

This type defines a digital certificate, digital signature algorithm, and key-length combination that
may be supported by the BIS implementation. This type is returned by

GetSignatureInfo()

to describe the combination(s) supported by the implementation.

//*******************************************************
// BIS_GET_SIGINFO_COUNT macro
// Tells how many EFI_BIS_SIGNATURE_INFO elements are contained
// in a EFI_BIS_DATA struct pointed to by the provided
// EFI_BIS_DATA*.
//*******************************************************
#define BIS_GET_SIGINFO_COUNT(

BisDataPtr) \

((

BisDataPtr)->Length/sizeof(EFI_BIS_SIGNATURE_INFO))

BisDataPtr

Supplies the pointer to the target

EFI_BIS_DATA

structure.

(return value)

The number of

EFI_BIS_SIGNATURE_INFO

elements contained in

the array.

This macro computes how many

EFI_BIS_SIGNATURE_INFO

elements are contained in an

EFI_BIS_DATA

structure returned from

GetSignatureInfo()

. The number returned is

the count of items in the list of supported digital certificate, digital signature algorithm, and key-
length combinations.

//*******************************************************
// BIS_GET_SIGINFO_ARRAY macro
// Produces a EFI_BIS_SIGNATURE_INFO* from a given
// EFI_BIS_DATA*.
//*******************************************************
#define BIS_GET_SIGINFO_ARRAY(

BisDataPtr) \

((EFI_BIS_SIGNATURE_INFO*)(

BisDataPtr)->Data)

BisDataPtr

Supplies the pointer to the target

EFI_BIS_DATA

structure.

(return value)

The pointer to the

EFI_BIS_SIGNATURE_INFO

array, cast as an

EFI_BIS_SIGNATURE_INFO*

.

This macro returns a pointer to the

EFI_BIS_SIGNATURE_INFO

array contained in an

EFI_BIS_DATA

structure returned from

GetSignatureInfo()

representing the list of

supported digital certificate, digital signature algorithm, and key-length combinations.

Advertising