estructura WHEA_ERROR_SOURCE_DESCRIPTOR (ntddk.h)

Artículo
08/07/2023

La estructura WHEA_ERROR_SOURCE_DESCRIPTOR describe un origen de error.

Sintaxis

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;

Miembros

Length

Tamaño, en bytes, de la estructura WHEA_ERROR_SOURCE_DESCRIPTOR.

Version

Número de versión de la estructura WHEA_ERROR_SOURCE_DESCRIPTOR. Este miembro contiene el valor WHEA_ERROR_SOURCE_DESCRIPTOR_VERSION_10.

Type

Valor de tipo WHEA_ERROR_SOURCE_TYPE que especifica el tipo del origen de error.

State

Valor de tipo WHEA_ERROR_SOURCE_STATE que especifica el estado del origen del error.

MaxRawDataLength

Número máximo de bytes de datos sin procesar incluidos en un paquete de error de hardware notificado por este origen de error. Este número debe ser lo suficientemente grande como para incluir cualquier información de error adicional específica de la plataforma que se agregue al paquete de error de hardware por parte del PSHED o por un complemento PSHED.

NumRecordsToPreallocate

Número de registros de error que se deben asignar previamente para los errores de hardware notificados por este origen de error.

MaxSectionsPerRecord

Número máximo de secciones de registro de errores necesarias en un registro de error para describir un error de hardware notificado por este origen de error. Este número debe ser lo suficientemente grande como para incluir las secciones de registro de errores adicionales que se agreguen al registro de errores por el PSHED o por un complemento PSHED durante el procesamiento del error.

ErrorSourceId

Identificador del origen del error. Este identificador solo es único en el sistema en el que existe el origen del error.

PlatformErrorSourceId

Identificador del origen de error enumerado por la plataforma de hardware. Este identificador solo es único en el sistema en el que existe el origen del error.

Flags

Combinación or'ed bit a bit de marcas que describe el origen del error. Las marcas posibles son:

WHEA_ERROR_SOURCE_FLAG_DEFAULTSOURCE

Esta marca indica que el origen del error es un origen de error predeterminado para el tipo de plataforma de hardware en la que existe.

WHEA_ERROR_SOURCE_FLAG_FIRMWAREFIRST

Esta marca indica que el firmware controla los errores notificados por este origen de error antes de pasar el control del procesamiento de errores de hardware al sistema operativo.

WHEA_ERROR_SOURCE_FLAG_GLOBAL

Esta marca indica que la configuración especificada para el origen de errores se aplicará a todos los orígenes de error del sistema que son del mismo tipo que los especificados en el miembro Type .

Info

Unión de estructuras descriptores específicas de cada tipo de origen de error diferente.

Info.XpfMceDescriptor

Estructura WHEA_XPF_MCE_DESCRIPTOR que describe un origen de error de excepción (MCE) de la comprobación de la máquina del procesador x86 o x64.

Info.XpfCmcDescriptor

Estructura de WHEA_XPF_CMC_DESCRIPTOR que describe un origen de error de comprobación de máquina (CMC) corregido por un procesador x86 o x64.

Info.XpfNmiDescriptor

Estructura WHEA_XPF_NMI_DESCRIPTOR que describe un origen de error de interrupción no enmascarable (NMI) del procesador x86 o x64.

Info.IpfMcaDescriptor

Estructura WHEA_IPF_MCA_DESCRIPTOR que describe un origen de error de anulación (MCA) de la máquina del procesador Itanium.

Info.IpfCmcDescriptor

Estructura de WHEA_IPF_CMC_DESCRIPTOR que describe un origen de error de comprobación de máquina corregida por el procesador Itanium (CMC).

Info.IpfCpeDescriptor

Estructura WHEA_IPF_CPE_DESCRIPTOR que describe un origen de error de error de plataforma (CPE) corregido por el procesador Itanium.

Info.AerRootportDescriptor

Estructura WHEA_AER_ROOTPORT_DESCRIPTOR que describe un origen de error de puerto raíz PCI Express (PCIe).

Info.AerEndpointDescriptor

Estructura WHEA_AER_ENDPOINT_DESCRIPTOR que describe un origen de error de punto de conexión PCIe.

Info.AerBridgeDescriptor

Estructura WHEA_AER_BRIDGE_DESCRIPTOR que describe un origen de error de puente PCIe.

Info.GenErrDescriptor

Estructura WHEA_GENERIC_ERROR_DESCRIPTOR que describe un origen de error genérico.

Info.GenErrDescriptorV2

Estructura WHEA_DEVICE_DRIVER_DESCRIPTOR_V2 .

Info.DeviceDriverDescriptor

Estructura WHEA_DEVICE_DRIVER_DESCRIPTOR .

Comentarios

La estructura WHEA_ERROR_SOURCE_DESCRIPTOR describe un origen de error. La estructura WHEA_ERROR_SOURCE_DESCRIPTOR también se usa para configurar un origen de error.

Una aplicación de administración de WHEA en modo de usuario puede controlar los orígenes de errores en el sistema llamando a los métodos de la clase de proveedor WMI WHEAErrorSourceMethods .

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con Windows Server 2008, Windows Vista SP1 y versiones posteriores de Windows.
Encabezado	ntddk.h (incluya Ntddk.h)