estructura WHEA_ERROR_PACKET_V1 (ntddk.h)

Artículo
03/08/2023

La estructura de 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_TYPE que indica el tipo de componente de hardware que informó del error de hardware.

ErrorSeverity

Valor de tipo WHEA_ERROR_SEVERITY que indica la gravedad de la condición de error.

ErrorSourceId

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

ErrorSourceType

Valor de tipo WHEA_ERROR_SOURCE_TYPE que 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 de WHEA_ERROR_PACKET_V1. Este miembro contiene el valor WHEA_ERROR_PKT_V1VERSION.

Cpu

Reservado para uso del sistema.

u

Una unión formada por los siguientes miembros:

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 se establece 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 se establece 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 se establece 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 se establece en WheaErrTypePCIExpress.

u.PciXBusError

Estructura WHEA_PCIXBUS_ERROR_SECTION que describe los datos de error del bus PCI o PCI-X. Este miembro solo se usa cuando el miembro ErrorType se establece 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 se establece en WheaErrTypePCIXDevice.

u.PmemError

RawDataFormat

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

RawDataOffset

Desplazamiento, en bytes, desde el principio del búfer de datos RawData 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 y como se especifica en el miembro Size .

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 .

Comentarios

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 Signature del 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 del 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 contenidos en una sección de error de paquete de error de hardware de un registro de error. Un registro de error contiene una sección de error de paquete de error de hardware solo si el miembro SectionType de una de las estructuras WHEA_ERROR_RECORD_SECTION_DESCRIPTOR que describen las secciones de registro de errores de ese registro de error contiene WHEA_PACKET_SECTION_GUID.