estrutura WHEA_ERROR_SOURCE_DESCRIPTOR (ntddk.h)
A estrutura WHEA_ERROR_SOURCE_DESCRIPTOR descreve uma fonte de erro.
Sintaxe
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;
Membros
Length
O tamanho, em bytes, da estrutura WHEA_ERROR_SOURCE_DESCRIPTOR.
Version
O número de versão da estrutura WHEA_ERROR_SOURCE_DESCRIPTOR. Esse membro contém o valor WHEA_ERROR_SOURCE_DESCRIPTOR_VERSION_10.
Type
Um valor de tipo WHEA_ERROR_SOURCE_TYPE que especifica o tipo da origem do erro.
State
Um valor de tipo WHEA_ERROR_SOURCE_STATE que especifica o estado da origem do erro.
MaxRawDataLength
O número máximo de bytes de dados brutos incluídos em um pacote de erro de hardware relatado por essa fonte de erro. Esse número deve ser grande o suficiente para incluir qualquer informação de erro adicional específica da plataforma adicionada ao pacote de erro de hardware pelo PSHED ou por um plug-in PSHED.
NumRecordsToPreallocate
O número de registros de erro que devem ser pré-alocados para erros de hardware relatados por essa fonte de erro.
MaxSectionsPerRecord
O número máximo de seções de registro de erro necessárias em um registro de erro para descrever um erro de hardware relatado por esta fonte de erro. Esse número deve ser grande o suficiente para incluir seções de registro de erro adicionais adicionadas ao registro de erro pelo PSHED ou por um plug-in PSHED durante o processamento do erro.
ErrorSourceId
O identificador da origem do erro. Esse identificador é exclusivo somente no sistema em que a origem do erro existe.
PlatformErrorSourceId
O identificador da origem do erro como enumerado pela plataforma de hardware. Esse identificador é exclusivo somente no sistema em que a origem do erro existe.
Flags
Uma combinação bit a bit or de sinalizadores que descreve a origem do erro. Os possíveis sinalizadores são:
WHEA_ERROR_SOURCE_FLAG_DEFAULTSOURCE
Esse sinalizador indica que a origem do erro é uma fonte de erro padrão para o tipo de plataforma de hardware na qual ela existe.
WHEA_ERROR_SOURCE_FLAG_FIRMWAREFIRST
Esse sinalizador indica que os erros relatados por essa fonte de erro são tratados pelo firmware antes que o controle do processamento de erros de hardware seja passado para o sistema operacional.
WHEA_ERROR_SOURCE_FLAG_GLOBAL
Esse sinalizador indica que as configurações especificadas para a origem do erro devem ser aplicadas a todas as fontes de erro no sistema que são do mesmo tipo especificado no membro Type .
Info
Uma união de estruturas de descritor específicas para cada tipo diferente de fonte de erro.
Info.XpfMceDescriptor
Uma estrutura de WHEA_XPF_MCE_DESCRIPTOR que descreve uma fonte de erro de mce (exceção de marcar do processador x86 ou x64).
Info.XpfCmcDescriptor
Uma estrutura WHEA_XPF_CMC_DESCRIPTOR que descreve uma fonte de erro de CMC (marcar de máquina) corrigida pelo processador x86 ou x64.
Info.XpfNmiDescriptor
Uma estrutura WHEA_XPF_NMI_DESCRIPTOR que descreve uma fonte de erro NMI (interrupção nãomaskável) do processador x86 ou x64.
Info.IpfMcaDescriptor
Uma estrutura WHEA_IPF_MCA_DESCRIPTOR que descreve uma fonte de erro mca (anulação de marcar de máquina do processador itanium).
Info.IpfCmcDescriptor
Uma estrutura de WHEA_IPF_CMC_DESCRIPTOR que descreve uma fonte de erro de CMC (marcar de máquina) corrigida pelo processador itanium.
Info.IpfCpeDescriptor
Uma estrutura de WHEA_IPF_CPE_DESCRIPTOR que descreve uma fonte de erro CPE (erro de plataforma) corrigida pelo processador itanium.
Info.AerRootportDescriptor
Uma estrutura WHEA_AER_ROOTPORT_DESCRIPTOR que descreve uma fonte de erro de porta raiz PCI Express (PCIe).
Info.AerEndpointDescriptor
Uma estrutura WHEA_AER_ENDPOINT_DESCRIPTOR que descreve uma fonte de erro de ponto de extremidade PCIe.
Info.AerBridgeDescriptor
Uma estrutura WHEA_AER_BRIDGE_DESCRIPTOR que descreve uma fonte de erro de ponte PCIe.
Info.GenErrDescriptor
Uma estrutura WHEA_GENERIC_ERROR_DESCRIPTOR que descreve uma fonte de erro genérica.
Info.GenErrDescriptorV2
Uma estrutura WHEA_DEVICE_DRIVER_DESCRIPTOR_V2 .
Info.DeviceDriverDescriptor
Uma estrutura WHEA_DEVICE_DRIVER_DESCRIPTOR .
Comentários
A estrutura WHEA_ERROR_SOURCE_DESCRIPTOR descreve uma fonte de erro. A estrutura WHEA_ERROR_SOURCE_DESCRIPTOR também é usada para configurar uma origem de erro.
Um aplicativo de gerenciamento WHEA no modo de usuário pode controlar as fontes de erro no sistema chamando os métodos na classe de provedor WMI WHEAErrorSourceMethods .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte no Windows Server 2008, Windows Vista SP1 e versões posteriores do Windows. |
| Cabeçalho | ntddk.h (inclua Ntddk.h) |
Confira também
WHEAErrorSourceMethods::D isableErrorSourceRtn
WHEAErrorSourceMethods::EnableErrorSourceRtn
WHEAErrorSourceMethods::GetAllErrorSourcesRtn
WHEAErrorSourceMethods::GetErrorSourceInfoRtn