Edit

BDCB_IMAGE_INFORMATION structure (ntddk.h)

  • Article

The BDCB_IMAGE_INFORMATION structure describes information about a boot-start driver that is about to be initialized, provided by Windows to a boot-start driver's BOOT_DRIVER_CALLBACK_FUNCTION routine.

Syntax

typedef struct _BDCB_IMAGE_INFORMATION {
  BDCB_CLASSIFICATION Classification;
  ULONG               ImageFlags;
  UNICODE_STRING      ImageName;
  UNICODE_STRING      RegistryPath;
  UNICODE_STRING      CertificatePublisher;
  UNICODE_STRING      CertificateIssuer;
  PVOID               ImageHash;
  PVOID               CertificateThumbprint;
  ULONG               ImageHashAlgorithm;
  ULONG               ThumbprintHashAlgorithm;
  ULONG               ImageHashLength;
  ULONG               CertificateThumbprintLength;
} BDCB_IMAGE_INFORMATION, *PBDCB_IMAGE_INFORMATION;

Members

Classification

An enumeration of type BDCB_CLASSIFICATION that the ELAM driver sets to specify the classification of the boot start image.

ImageFlags

Bit flags that describe the image. The following values are defined.

Value Meaning
Bit 0 The boot start image is a dependent DLL.
Bit 1 The boot start image failed code integrity but load was allowed because of boot policy (code integrity not required on the platform, or code integrity disabled because of boot setting, debugging, or both). The symbolic name for bit 1 is `BDCB_IMAGEFLAGS_FAILED_CODE_INTEGRITY.`
Bits 2-31 Do not use. Reserved.

ImageName

The name of the boot-start driver's binary image.

RegistryPath

The path in the registry where the boot-start driver is registered.

CertificatePublisher

The publisher of the image's certificate. If the image is not signed, the string is empty ("").

CertificateIssuer

The issuer of the image's certificate. If the image is not signed, the string is empty ("").

ImageHash

The Authenticode hash of the image, which can be calculated by using SignTool.exe (Sign Tool).

CertificateThumbprint

The hash of the certificate of the signer to be signed. Run certutil –dump x,cer to view this value as "Signature Hash".

ImageHashAlgorithm

The algorithm of the image hash. The following values are listed for reference.

Value
ALG_CLASS_HASH
ALG_CLASS_ANY
ALG_SID_MD5
ALG_SID_SHA1
ALG_SID_SHA_256
ALG_SID_SHA_384
ALG_SID_SHA_512
CALG_MD5
CALG_SHA1
CALG_SHA_256
CALG_SHA_384
CALG_SHA_512

ThumbprintHashAlgorithm

The algorithm of the certificate thumbprint. This member should be ignored if CertificateThumbprint is NULL.

ImageHashLength

The length of data pointed to by the ImageHash member.

CertificateThumbprintLength

The length of data pointed to by the CertificateThumbprint member.

Requirements

Requirement Value
Minimum supported client Available starting with Windows 8.
Header ntddk.h (include Ntddk.h)

See also

BDCB_CLASSIFICATION

BOOT_DRIVER_CALLBACK_FUNCTION

ALG_ID