estrutura WHEA_PCIEXPRESS_ERROR_SECTION (ntddk.h)
A estrutura WHEA_PCIEXPRESS_ERROR_SECTION descreve os dados de erro do PCI Express (PCIe).
Sintaxe
typedef struct _WHEA_PCIEXPRESS_ERROR_SECTION {
WHEA_PCIEXPRESS_ERROR_SECTION_VALIDBITS ValidBits;
WHEA_PCIEXPRESS_DEVICE_TYPE PortType;
WHEA_PCIEXPRESS_VERSION Version;
WHEA_PCIEXPRESS_COMMAND_STATUS CommandStatus;
ULONG Reserved;
WHEA_PCIEXPRESS_DEVICE_ID DeviceId;
ULONGLONG DeviceSerialNumber;
WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS BridgeControlStatus;
UCHAR ExpressCapability[60];
UCHAR AerInfo[96];
} WHEA_PCIEXPRESS_ERROR_SECTION, *PWHEA_PCIEXPRESS_ERROR_SECTION;
Membros
ValidBits
Uma união WHEA_PCIEXPRESS_ERROR_SECTION_VALIDBITS que especifica quais membros dessa estrutura contêm dados válidos.
PortType
O tipo de dispositivo ou o tipo de porta do componente PCIe em que o erro ocorreu. Os valores possíveis são:
WheaPciExpressEndpoint
Um dispositivo de ponto de extremidade PCIe.
WheaPciExpressLegacyEndpoint
Um dispositivo de ponto de extremidade PCIe herdado.
WheaPciExpressRootPort
Uma porta raiz de um complexo raiz PCIe.
WheaPciExpressUpstreamSwitchPort
Uma porta upstream de um comutador PCIe.
WheaPciExpressDownstreamSwitchPort
Uma porta downstream de um comutador PCIe.
WheaPciExpressToPciXBridge
Uma ponte PCIe para PCI ou PCI-X.
WheaPciXToExpressBridge
Uma ponte PCI ou PCI-X para PCIe.
WheaPciExpressRootComplexIntegratedEndpoint
Um dispositivo de ponto de extremidade PCIe integrado ao complexo raiz.
WheaPciExpressRootComplexEventCollector
Um coletor de eventos complexos raiz PCIe.
Esse membro conterá dados válidos somente se o bit ValidBits.PortType estiver definido.
Version
Uma união WHEA_PCIEXPRESS_VERSION que contém a versão da especificação PCIe compatível com a plataforma de hardware. A união WHEA_PCIEXPRESS_VERSION é definida da seguinte maneira:
typedef union _WHEA_PCIEXPRESS_VERSION {
struct {
UCHAR MinorVersion;
UCHAR MajorVersion;
USHORT Reserved;
};
ULONG AsULONG;
} WHEA_PCIEXPRESS_VERSION, *PWHEA_PCIEXPRESS_VERSION;
MinorVersion
O número da versão secundária.
MajorVersion
O número da versão principal.
Reservado
Reservado para uso do sistema.
AsULONG
Uma representação ULONG do conteúdo da união WHEA_PCIEXPRESS_VERSION .
Esse membro conterá dados válidos somente se o bit ValidBits.Version estiver definido.
CommandStatus
Uma união WHEA_PCIEXPRESS_COMMAND_STATUS que contém o conteúdo do comando PCI e status registros do dispositivo PCIe em que o erro ocorreu. A união WHEA_PCIEXPRESS_COMMAND_STATUS é definida da seguinte maneira:
typedef union _WHEA_PCIEXPRESS_COMMAND_STATUS {
struct {
USHORT Command;
USHORT Status;
};
ULONG AsULONG;
} WHEA_PCIEXPRESS_COMMAND_STATUS, *PWHEA_PCIEXPRESS_COMMAND_STATUS;
Comando
O conteúdo do registro de comando PCI.
Status
O conteúdo do registro de status PCI.
AsULONG (CommandStatus)
Uma representação ULONG do conteúdo da união WHEA_PCIEXPRESS_COMMAND_STATUS .
Esse membro conterá dados válidos somente se o bit ValidBits.CommandStatus estiver definido.
Reserved
Reservado para uso do sistema.
DeviceId
Uma estrutura WHEA_PCIEXPRESS_DEVICE_ID que contém dados que identificam o dispositivo PCIe em que o erro ocorreu. A estrutura WHEA_PCIEXPRESS_DEVICE_ID é definida da seguinte maneira:
typedef struct _WHEA_PCIEXPRESS_DEVICE_ID {
USHORT VendorID;
USHORT DeviceID;
ULONG ClassCode:24;
ULONG FunctionNumber:8;
ULONG DeviceNumber:8;
ULONG Segment:16;
ULONG PrimaryBusNumber:8;
ULONG SecondaryBusNumber:8;
ULONG Reserved1:3;
ULONG SlotNumber:13; ULONG Reserved2:8;
} WHEA_PCIEXPRESS_DEVICE_ID, *PWHEA_PCIEXPRESS_DEVICE_ID;
VendorID
A ID do fornecedor do dispositivo.
deviceId
A ID do dispositivo.
ClassCode
O código de classe do dispositivo.
FunctionNumber
O número da função do dispositivo no barramento.
DeviceNumber
O número do dispositivo no barramento.
Segment
O número do segmento de barramento que contém o dispositivo.
PrimaryBusNumber
O número do barramento primário da porta/ponte raiz ou o número do barramento do dispositivo.
SecondaryBusNumber
O número do barramento secundário de porta/ponte raiz.
Reserved1
Reservado para uso do sistema.
SlotNumber
O número do slot em que o dispositivo está localizado no sistema.
Reserved2
Reservado para uso do sistema.
Esse membro conterá dados válidos somente se o bit ValidBits.DeviceId estiver definido.
DeviceSerialNumber
O número de série do dispositivo PCIe em que o erro ocorreu.
Esse membro conterá dados válidos somente se o bit ValidBits.DeviceSerialNumber estiver definido.
BridgeControlStatus
Uma união WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS que contém o conteúdo do controle PCI e registros de status secundários do dispositivo de ponte em que ocorreu o erro. A união WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS é definida da seguinte maneira:
typedef union _WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS {
struct {
USHORT BridgeSecondaryStatus;
USHORT BridgeControl;
};
ULONG AsULONG;
} WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS, *PWHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS;
BridgeSecondaryStatus
O conteúdo do registro de status secundário do dispositivo de ponte.
BridgeControl
O conteúdo do registro de controle do dispositivo de ponte.
AsULONG (BridgeControlStatus)
Uma representação ULONG do conteúdo da união WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS .
Esse membro conterá dados válidos somente se o bit ValidBits.BridgeControlStatus estiver definido.
ExpressCapability[60]
Um buffer que contém uma estrutura PCI_EXPRESS_CAPABILITY que descreve a estrutura de funcionalidade PCIe do dispositivo em que o erro ocorreu.
Esse membro conterá dados válidos somente se o bit ValidBits.ExpressCapability estiver definido.
AerInfo[96]
Um buffer que contém uma estrutura PCI_EXPRESS_AER_CAPABILITY que descreve a estrutura de funcionalidade estendida do AER (relatório de erros avançados) pcIe para o dispositivo em que o erro ocorreu.
Esse membro conterá dados válidos somente se o bit ValidBits.AerInfo estiver definido.
Comentários
A estrutura WHEA_PCIEXPRESS_ERROR_SECTION descreve os dados de erro contidos em uma seção de erro PCI Express (PCIe) de um registro de erro. Um registro de erro conterá uma seção de erro PCIe 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 PCIEXPRESS_ERROR_SECTION_GUID.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ntddk.h (inclua Ntddk.h) |