estructura WHEA_ERROR_PACKET_V1 (ntddk.h)

Artículo
02/07/2025

La estructura WHEA_ERROR_PACKET_V1 describe los datos de error de hardware que se pasan al sistema operativo mediante un controlador de errores de hardware de bajo nivel (LLHEH).

La estructura WHEA_ERROR_PACKET_V1 se admite en Windows Server 2008 y Windows Vista SP1.

Para Windows 7 y versiones posteriores de Windows, use la estructura WHEA_ERROR_PACKET_V2.

Sintaxis

typedef struct _WHEA_ERROR_PACKET_V1 {
  ULONG                   Signature;
  WHEA_ERROR_PACKET_FLAGS Flags;
  ULONG                   Size;
  ULONG                   RawDataLength;
  ULONGLONG               Reserved1;
  ULONGLONG               Context;
  WHEA_ERROR_TYPE         ErrorType;
  WHEA_ERROR_SEVERITY     ErrorSeverity;
  ULONG                   ErrorSourceId;
  WHEA_ERROR_SOURCE_TYPE  ErrorSourceType;
  ULONG                   Reserved2;
  ULONG                   Version;
  ULONGLONG               Cpu;
  union {
    WHEA_PROCESSOR_GENERIC_ERROR_SECTION ProcessorError;
    WHEA_MEMORY_ERROR_SECTION            MemoryError;
    WHEA_NMI_ERROR_SECTION               NmiError;
    WHEA_PCIEXPRESS_ERROR_SECTION        PciExpressError;
    WHEA_PCIXBUS_ERROR_SECTION           PciXBusError;
    WHEA_PCIXDEVICE_ERROR_SECTION        PciXDeviceError;
    WHEA_PMEM_ERROR_SECTION              PmemError;
  } u;
  WHEA_RAW_DATA_FORMAT    RawDataFormat;
  ULONG                   RawDataOffset;
  UCHAR                   RawData[1];
} WHEA_ERROR_PACKET_V1, *PWHEA_ERROR_PACKET_V1, WHEA_ERROR_PACKET, *PWHEA_ERROR_PACKET;

Miembros

Signature

Firma del paquete de error de hardware. Este miembro contiene el valor WHEA_ERROR_PACKET_V1_SIGNATURE.

Flags

Unión WHEA_ERROR_PACKET_FLAGS que describe la condición de error.

Size

Tamaño, en bytes, del paquete de error de hardware, incluidos los datos sin procesar.

RawDataLength

Longitud, en bytes, de los datos contenidos en el miembro RawData.

Reserved1

Reservado para uso del sistema.

Context

Reservado para uso del sistema.

ErrorType

Valor de tipo WHEA_ERROR_TYPEque indica el tipo de componente de hardware que notificó el error de hardware.

ErrorSeverity

Valor de tipo WHEA_ERROR_SEVERITYque indica la gravedad de la condición de error.

ErrorSourceId

Identificador del origen de error que informó del error de hardware.

ErrorSourceType

Valor de tipo WHEA_ERROR_SOURCE_TYPEque indica el tipo de origen de error que informó del error de hardware.

Reserved2

Reservado para uso del sistema.

Version

Versión de la estructura WHEA_ERROR_PACKET_V1. Este miembro contiene el valor WHEA_ERROR_PKT_V1VERSION.

Cpu

Reservado para uso del sistema.

u

Unión formada por los miembros siguientes:

u.ProcessorError

Estructura WHEA_PROCESSOR_GENERIC_ERROR_SECTION que describe los datos de error del procesador. Este miembro solo se usa cuando el miembro ErrorType está establecido en WheaErrTypeProcessor.

u.MemoryError

Estructura WHEA_MEMORY_ERROR_SECTION que describe los datos de error de memoria. Este miembro solo se usa cuando el miembro ErrorType está establecido en WheaErrTypeMemory.

u.NmiError

Estructura WHEA_NMI_ERROR_SECTION que describe los datos de error de interrupción no enmascarables (NMI). Este miembro solo se usa cuando el miembro ErrorType está establecido en WheaErrTypeNMI.

u.PciExpressError

Estructura WHEA_PCIEXPRESS_ERROR_SECTION que describe los datos de error de PCI Express (PCIe). Este miembro solo se usa cuando el miembro ErrorType está establecido en WheaErrTypePCIExpress.

u.PciXBusError

Estructura WHEA_PCIXBUS_ERROR_SECTION que describe los datos de error de PCI o PCI-X bus. Este miembro solo se usa cuando el miembro ErrorType está establecido en WheaErrTypePCIXBus.

u.PciXDeviceError

Estructura WHEA_PCIXDEVICE_ERROR_SECTION que describe los datos de error del dispositivo PCI o PCI-X. Este miembro solo se usa cuando el miembro ErrorType está establecido en WheaErrTypePCIXDevice.

u.PmemError

RawDataFormat

Valor WHEA_RAW_DATA_FORMATcon tipo que indica el formato de la información de error de hardware contenida en el búfer de datos de RawData.

RawDataOffset

Un desplazamiento, en bytes, desde el principio del RawData búfer de datos donde un complemento PSHED puede agregar información de error adicional específica de la plataforma al paquete de error de hardware. La cantidad de información complementaria que se puede agregar al paquete de error de hardware está limitada por el tamaño total del paquete, tal como se especifica en el miembro Size de.

RawData[1]

Un búfer de datos de tamaño variable que contiene la información de error de hardware sin procesar de los registros de estado del origen del error. El formato de los datos de error de hardware se especifica mediante el miembro RawDataFormat.

Observaciones

La estructura WHEA_ERROR_PACKET_V1 se usa para notificar un error de hardware en Windows Server 2008 y Windows Vista SP1.

Si los complementos de controlador de error de hardware (PSHED) específicos de la plataforma se ejecutan en cualquier versión de Windows compatible con WHEA, puede inspeccionar la versión de WHEA_ERROR_PACKET siguiendo estos pasos:

Si el miembro firma de para el WHEA_ERROR_PACKET es igual a WHEA_ERROR_PACKET_V1_SIGNATURE, el código se ejecuta en una versión temprana de Windows y el paquete de error tiene el formato de estructura WHEA_ERROR_PACKET_V1.
Si el miembro signature de la WHEA_ERROR_PACKET es igual a WHEA_ERROR_PACKET_V2_SIGNATURE, el código se ejecuta en una versión posterior de Windows y el paquete de error tiene el formato de estructura WHEA_ERROR_PACKET_V2.

Un LLHEH pasa una estructura de WHEA_ERROR_PACKET_V1 al sistema operativo cuando notifica un error de hardware. Este paquete de error de hardware contiene los datos de error de hardware sin procesar directamente de los registros de estado de error del origen del error.

La estructura WHEA_ERROR_PACKET_V1 describe los datos de error que se encuentran en una sección de error de paquete de error de hardware de una registro de errores. Un registro de error contiene una sección de error de paquete de error de hardware solo si el SectionType miembro de una de las estructuras de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR que describen las secciones del registro de errores para ese registro de error contiene WHEA_PACKET_SECTION_GUID.