WHEA_ERROR_SOURCE_DESCRIPTOR 구조체(ntddk.h)

아티클
08/07/2023

WHEA_ERROR_SOURCE_DESCRIPTOR 구조는 오류 원본을 설명합니다.

구문

typedef struct _WHEA_ERROR_SOURCE_DESCRIPTOR {
  ULONG                   Length;
  ULONG                   Version;
  WHEA_ERROR_SOURCE_TYPE  Type;
  WHEA_ERROR_SOURCE_STATE State;
  ULONG                   MaxRawDataLength;
  ULONG                   NumRecordsToPreallocate;
  ULONG                   MaxSectionsPerRecord;
  ULONG                   ErrorSourceId;
  ULONG                   PlatformErrorSourceId;
  ULONG                   Flags;
  union {
    WHEA_XPF_MCE_DESCRIPTOR          XpfMceDescriptor;
    WHEA_XPF_CMC_DESCRIPTOR          XpfCmcDescriptor;
    WHEA_XPF_NMI_DESCRIPTOR          XpfNmiDescriptor;
    WHEA_IPF_MCA_DESCRIPTOR          IpfMcaDescriptor;
    WHEA_IPF_CMC_DESCRIPTOR          IpfCmcDescriptor;
    WHEA_IPF_CPE_DESCRIPTOR          IpfCpeDescriptor;
    WHEA_AER_ROOTPORT_DESCRIPTOR     AerRootportDescriptor;
    WHEA_AER_ENDPOINT_DESCRIPTOR     AerEndpointDescriptor;
    WHEA_AER_BRIDGE_DESCRIPTOR       AerBridgeDescriptor;
    WHEA_GENERIC_ERROR_DESCRIPTOR    GenErrDescriptor;
    WHEA_GENERIC_ERROR_DESCRIPTOR_V2 GenErrDescriptorV2;
    WHEA_DEVICE_DRIVER_DESCRIPTOR    DeviceDriverDescriptor;
  } Info;
} *PWHEA_ERROR_SOURCE_DESCRIPTOR, WHEA_ERROR_SOURCE_DESCRIPTOR;

멤버

Length

WHEA_ERROR_SOURCE_DESCRIPTOR 구조체의 크기(바이트)입니다.

Version

WHEA_ERROR_SOURCE_DESCRIPTOR 구조체의 버전 번호입니다. 이 멤버에는 WHEA_ERROR_SOURCE_DESCRIPTOR_VERSION_10 값이 포함됩니다.

Type

오류 원본의 형식을 지정하는 WHEA_ERROR_SOURCE_TYPE 형식의 값입니다.

State

오류 원본의 상태를 지정하는 WHEA_ERROR_SOURCE_STATE 형식의 값입니다.

MaxRawDataLength

이 오류 원본에서 보고하는 하드웨어 오류 패킷에 포함된 원시 데이터의 최대 바이트 수입니다. 이 숫자는 PSHED 또는 PSHED 플러그 인에 의해 하드웨어 오류 패킷에 추가되는 추가 플랫폼별 오류 정보를 포함할 수 있을 만큼 커야 합니다.

NumRecordsToPreallocate

이 오류 원본에서 보고하는 하드웨어 오류에 대해 미리 할당해야 하는 오류 레코드 수입니다.

MaxSectionsPerRecord

이 오류 원본에서 보고하는 하드웨어 오류를 설명하기 위해 오류 레코드에 필요한 최대 오류 레코드 섹션 수입니다. 이 숫자는 오류 처리 중 PSHED 또는 PSHED 플러그 인에 의해 오류 레코드에 추가되는 추가 오류 레코드 섹션을 포함할 만큼 충분히 커야 합니다.

ErrorSourceId

오류 원본의 식별자입니다. 이 식별자는 오류 원본이 있는 시스템에서만 고유합니다.

PlatformErrorSourceId

하드웨어 플랫폼에서 열거한 오류 원본의 식별자입니다. 이 식별자는 오류 원본이 있는 시스템에서만 고유합니다.

Flags

오류 원본을 설명하는 플래그의 비트 OR 조합입니다. 가능한 플래그는 다음과 같습니다.

WHEA_ERROR_SOURCE_FLAG_DEFAULTSOURCE

이 플래그는 오류 원본이 존재하는 하드웨어 플랫폼 유형에 대한 기본 오류 원본임을 나타냅니다.

WHEA_ERROR_SOURCE_FLAG_FIRMWAREFIRST

이 플래그는 하드웨어 오류 처리 제어가 운영 체제에 전달되기 전에 이 오류 원본에서 보고하는 오류가 펌웨어에서 처리됨을 나타냅니다.

WHEA_ERROR_SOURCE_FLAG_GLOBAL

이 플래그는 오류 원본에 대해 지정된 설정이 Type 멤버에 지정된 형식과 동일한 시스템의 모든 오류 원본에 적용되어야 했음을 나타냅니다.

Info

서로 다른 유형의 오류 원본과 관련된 설명자 구조체의 합집합입니다.

Info.XpfMceDescriptor

x86 또는 x64 프로세서 머신 검사 예외(MCE) 오류 원본을 설명하는 WHEA_XPF_MCE_DESCRIPTOR 구조체입니다.

Info.XpfCmcDescriptor

x86 또는 x64 프로세서 수정된 CMC(컴퓨터 검사) 오류 원본을 설명하는 WHEA_XPF_CMC_DESCRIPTOR 구조체입니다.

Info.XpfNmiDescriptor

x86 또는 x64 프로세서 NMI(마스크할 수 없는 인터럽트) 오류 원본을 설명하는 WHEA_XPF_NMI_DESCRIPTOR 구조체입니다.

Info.IpfMcaDescriptor

ITanium 프로세서 머신 검사 중단(MCA) 오류 원본을 설명하는 WHEA_IPF_MCA_DESCRIPTOR 구조체입니다.

Info.IpfCmcDescriptor

ITanium 프로세서 수정된 CMC(컴퓨터 검사) 오류 원본을 설명하는 WHEA_IPF_CMC_DESCRIPTOR 구조체입니다.

Info.IpfCpeDescriptor

Itanium 프로세서 CPE(플랫폼 오류) 오류 원본을 설명하는 WHEA_IPF_CPE_DESCRIPTOR 구조체입니다.

Info.AerRootportDescriptor

PCI Express(PCIe) 루트 포트 오류 원본을 설명하는 WHEA_AER_ROOTPORT_DESCRIPTOR 구조체입니다.

Info.AerEndpointDescriptor

PCIe 엔드포인트 오류 원본을 설명하는 WHEA_AER_ENDPOINT_DESCRIPTOR 구조체입니다.

Info.AerBridgeDescriptor

PCIe 브리지 오류 원본을 설명하는 WHEA_AER_BRIDGE_DESCRIPTOR 구조체입니다.

Info.GenErrDescriptor

제네릭 오류 원본을 설명하는 WHEA_GENERIC_ERROR_DESCRIPTOR 구조체입니다.

Info.GenErrDescriptorV2

WHEA_DEVICE_DRIVER_DESCRIPTOR_V2 구조체입니다.

Info.DeviceDriverDescriptor

WHEA_DEVICE_DRIVER_DESCRIPTOR 구조체입니다.

설명

WHEA_ERROR_SOURCE_DESCRIPTOR 구조는 오류 원본을 설명합니다. WHEA_ERROR_SOURCE_DESCRIPTOR 구조는 오류 원본을 구성하는 데도 사용됩니다.

사용자 모드 WHEA 관리 애플리케이션은 WHEAErrorSourceMethods WMI 공급자 클래스에서 메서드를 호출하여 시스템의 오류 원본을 제어할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Server 2008, Windows Vista SP1 이상 버전의 Windows에서 지원됩니다.
머리글	ntddk.h(Ntddk.h 포함)