estrutura WHEA_ERROR_PACKET_V1 (ntddk.h)

Artigo
03/08/2023

A estrutura WHEA_ERROR_PACKET_V1 descreve os dados de erro de hardware que são passados para o sistema operacional por um LLHEH (manipulador de erros de hardware) de baixo nível.

A estrutura de WHEA_ERROR_PACKET_V1 tem suporte no Windows Server 2008 e no Windows Vista SP1.

Para o Windows 7 e versões posteriores do Windows, use a estrutura WHEA_ERROR_PACKET_V2 .

Sintaxe

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;

Membros

Signature

A assinatura do pacote de erro de hardware. Esse membro contém o valor WHEA_ERROR_PACKET_V1_SIGNATURE.

Flags

Uma união WHEA_ERROR_PACKET_FLAGS que descreve a condição de erro.

Size

O tamanho, em bytes, do pacote de erro de hardware, incluindo os dados brutos.

RawDataLength

O comprimento, em bytes, dos dados contidos no membro RawData .

Reserved1

Reservado para uso do sistema.

Context

Reservado para uso do sistema.

ErrorType

Um valor de tipo WHEA_ERROR_TYPE que indica o tipo de componente de hardware que relatou o erro de hardware.

ErrorSeverity

Um valor de tipo WHEA_ERROR_SEVERITY que indica a gravidade da condição de erro.

ErrorSourceId

O identificador da origem do erro que relatou o erro de hardware.

ErrorSourceType

Um valor de tipo WHEA_ERROR_SOURCE_TYPE que indica o tipo de origem do erro que relatou o erro de hardware.

Reserved2

Reservado para uso do sistema.

Version

A versão da estrutura WHEA_ERROR_PACKET_V1. Esse membro contém o valor WHEA_ERROR_PKT_V1VERSION.

Cpu

Reservado para uso do sistema.

u

Uma união composta pelos seguintes membros:

u.ProcessorError

Uma estrutura WHEA_PROCESSOR_GENERIC_ERROR_SECTION que descreve os dados de erro do processador. Esse membro é usado somente quando o membro ErrorType é definido como WheaErrTypeProcessor.

u.MemoryError

Uma estrutura WHEA_MEMORY_ERROR_SECTION que descreve os dados de erro de memória. Esse membro é usado somente quando o membro ErrorType é definido como WheaErrTypeMemory.

u.NmiError

Uma estrutura de WHEA_NMI_ERROR_SECTION que descreve os dados de erro NMI (interrupção não gravável). Esse membro é usado somente quando o membro ErrorType é definido como WheaErrTypeNMI.

u.PciExpressError

Uma estrutura WHEA_PCIEXPRESS_ERROR_SECTION que descreve os dados de erro do PCI Express (PCIe). Esse membro é usado somente quando o membro ErrorType é definido como WheaErrTypePCIExpress.

u.PciXBusError

Uma estrutura WHEA_PCIXBUS_ERROR_SECTION que descreve dados de erro de barramento PCI ou PCI-X. Esse membro é usado somente quando o membro ErrorType é definido como WheaErrTypePCIXBus.

u.PciXDeviceError

Uma estrutura WHEA_PCIXDEVICE_ERROR_SECTION que descreve dados de erro de dispositivo PCI ou PCI-X. Esse membro é usado somente quando o membro ErrorType é definido como WheaErrTypePCIXDevice.

u.PmemError

RawDataFormat

Um valor de tipo WHEA_RAW_DATA_FORMAT que indica o formato das informações de erro de hardware contidas no buffer de dados RawData .

RawDataOffset

Um deslocamento, em bytes, desde o início do buffer de dados RawData em que um plug-in PSHED pode adicionar informações de erro específicas da plataforma complementar ao pacote de erro de hardware. A quantidade de informações suplementares que podem ser adicionadas ao pacote de erro de hardware é limitada pelo tamanho total do pacote, conforme especificado no membro Size .

RawData[1]

Um buffer de dados de tamanho variável que contém as informações de erro de hardware brutas dos registros de status da fonte de erro. O formato dos dados de erro de hardware é especificado pelo membro RawDataFormat .

Comentários

A estrutura WHEA_ERROR_PACKET_V1 é usada para relatar um erro de hardware no Windows Server 2008 e no Windows Vista SP1.

Se os plug-ins do PSHED (driver de erro de hardware) específicos da plataforma forem executados em qualquer versão do Windows compatível com WHEA, você poderá inspecionar a versão do WHEA_ERROR_PACKET seguindo estas etapas:

Se o membro Signature do WHEA_ERROR_PACKET for igual a WHEA_ERROR_PACKET_V1_SIGNATURE, o código será executado em uma versão anterior do Windows e o pacote de erro será formatado como uma estrutura WHEA_ERROR_PACKET_V1 .
Se o membro Signature do WHEA_ERROR_PACKET for igual a WHEA_ERROR_PACKET_V2_SIGNATURE, o código será executado em uma versão posterior do Windows e o pacote de erro será formatado como uma estrutura WHEA_ERROR_PACKET_V2 .

Um LLHEH passa uma estrutura WHEA_ERROR_PACKET_V1 para o sistema operacional quando ele relata um erro de hardware. Esse pacote de erro de hardware contém os dados brutos de erro de hardware diretos do erro da fonte de erro status registros.

A estrutura WHEA_ERROR_PACKET_V1 descreve os dados de erro contidos em uma seção de erro de pacote de erro de hardware de um registro de erro. Um registro de erro contém uma seção de erro de pacote de erro de hardware somente se o membro SectionType de uma das estruturas de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR que descrevem as seções de registro de erro para esse registro de erro contiver WHEA_PACKET_SECTION_GUID.