WHEA_ERROR_PACKET_V1 構造体 (ntddk.h)

[アーティクル]
08/07/2023

WHEA_ERROR_PACKET_V1構造では、低レベルのハードウェアエラーハンドラー (LLHEH) によってオペレーティングシステムに渡されるハードウェアエラーデータについて説明します。

WHEA_ERROR_PACKET_V1構造は、Windows Server 2008 および Windows Vista SP1 でサポートされています。

Windows 7 以降のバージョンの Windows の場合は、 WHEA_ERROR_PACKET_V2 構造を使用します。

構文

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;

メンバー

Signature

ハードウェアエラーパケットの署名。このメンバーには、WHEA_ERROR_PACKET_V1_SIGNATURE値が含まれています。

Flags

エラー条件を記述する WHEA_ERROR_PACKET_FLAGS 共用体。

Size

生データを含むハードウェアエラーパケットのサイズ (バイト単位)。

RawDataLength

RawData メンバーに含まれるデータの長さ (バイト単位)。

Reserved1

システムで使用するために予約されています。

Context

システムで使用するために予約されています。

ErrorType

ハードウェアエラーを報告したハードウェアコンポーネントの種類を示す、WHEA_ERROR_TYPE型指定された値。

ErrorSeverity

エラー条件の重大度を示す WHEA_ERROR_SEVERITY型指定の値。

ErrorSourceId

ハードウェアエラーを報告したエラーソースの識別子。

ErrorSourceType

ハードウェアエラーを報告したエラーソースの種類を示す、 WHEA_ERROR_SOURCE_TYPE型指定された値。

Reserved2

システムで使用するために予約されています。

Version

WHEA_ERROR_PACKET_V1構造体のバージョン。このメンバーには、WHEA_ERROR_PKT_V1VERSION値が含まれています。

Cpu

システムで使用するために予約されています。

u

次のメンバーで構成される共用体。

u.ProcessorError

プロセッサエラーデータを記述する WHEA_PROCESSOR_GENERIC_ERROR_SECTION 構造体。このメンバーは、 ErrorType メンバーが WheaErrTypeProcessor に設定されている場合にのみ使用されます。

u.MemoryError

メモリエラーデータを記述する WHEA_MEMORY_ERROR_SECTION 構造体。このメンバーは、 ErrorType メンバーが WheaErrTypeMemory に設定されている場合にのみ使用されます。

u.NmiError

マスクできない割り込み (NMI) エラーデータを記述する WHEA_NMI_ERROR_SECTION 構造体。このメンバーは、 ErrorType メンバーが WheaErrTypeNMI に設定されている場合にのみ使用されます。

u.PciExpressError

PCI Express (PCIe) エラーデータを記述する WHEA_PCIEXPRESS_ERROR_SECTION 構造。このメンバーは、 ErrorType メンバーが WheaErrTypePCIExpress に設定されている場合にのみ使用されます。

u.PciXBusError

PCI または PCI-X バスのエラーデータを記述する WHEA_PCIXBUS_ERROR_SECTION 構造。このメンバーは、 ErrorType メンバーが WheaErrTypePCIXBus に設定されている場合にのみ使用されます。

u.PciXDeviceError

PCI または PCI-X デバイスのエラーデータを記述する WHEA_PCIXDEVICE_ERROR_SECTION 構造。このメンバーは、 ErrorType メンバーが WheaErrTypePCIXDevice に設定されている場合にのみ使用されます。

u.PmemError

RawDataFormat

RawData データバッファーに含まれるハードウェアエラー情報の形式を示す、WHEA_RAW_DATA_FORMAT型指定の値。

RawDataOffset

PSHED プラグインがハードウェアエラーパケットに補足プラットフォーム固有のエラー情報を追加できる RawData データバッファーの先頭からのオフセット (バイト単位)。ハードウェアエラーパケットに追加できる補足情報の量は、 Size メンバーで指定されているパケットの合計サイズによって制限されます。

RawData[1]

エラーソースの状態レジスタからの生のハードウェアエラー情報を含む可変サイズのデータバッファー。ハードウェアエラーデータの形式は、 RawDataFormat メンバーによって指定されます。

注釈

WHEA_ERROR_PACKET_V1構造は、Windows Server 2008 および Windows Vista SP1 でハードウェアエラーを報告するために使用されます。

プラットフォーム固有のハードウェアエラードライバー (PSHED) プラグインが WHEA 互換の Windows バージョンで実行されている場合は、次の手順に従ってWHEA_ERROR_PACKETのバージョンを調べることができます。

WHEA_ERROR_PACKETの Signature メンバーが WHEA_ERROR_PACKET_V1_SIGNATURE と等しい場合、コードは Windows の初期バージョンで実行されており、エラーパケットは WHEA_ERROR_PACKET_V1 構造として書式設定されます。
WHEA_ERROR_PACKETの Signature メンバーが WHEA_ERROR_PACKET_V2_SIGNATURE と等しい場合、コードは新しいバージョンの Windows で実行され、エラーパケットは WHEA_ERROR_PACKET_V2 構造として書式設定されます。

LLHEH は、ハードウェアエラーが報告されたときに 、オペレーティング システムにWHEA_ERROR_PACKET_V1構造体を渡します。このハードウェアエラーパケットには、エラーソースのエラー状態レジスタから直接送信される生のハードウェアエラーデータが含まれています。

WHEA_ERROR_PACKET_V1構造体は、エラーレコードのハードウェアエラーパケットエラーセクションに含まれるエラーデータを記述します。エラーレコードにハードウェアエラーパケットエラーセクションが含まれるのは、そのエラーレコードのエラーレコードセクションを記述するWHEA_ERROR_RECORD_SECTION_DESCRIPTOR構造体の 1 つの SectionType メンバーにWHEA_PACKET_SECTION_GUIDが含まれている場合のみです。

要件

要件	値
サポートされている最小のクライアント	Windows Server 2008 および Windows Vista SP1 でサポートされています。
Header	ntddk.h (Ntddk.h を含む)