Função WheaFindErrorRecordSection (ntddk.h)
A função WheaFindErrorRecordSection pesquisa uma seção de registro de erro da WHEA (Arquitetura de Erro de Hardware do Windows) especificada em um registro de erro do WHEA . A seção registro de erro é formatada como uma estrutura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR.
Sintaxe
NTSTATUS WheaFindErrorRecordSection(
[in] PWHEA_ERROR_RECORD Record,
[in] const GUID *SectionType,
[out] PWHEA_ERROR_RECORD_SECTION_DESCRIPTOR *SectionDescriptor,
[out, optional] PVOID *SectionData
);
Parâmetros
[in] Record
Um ponteiro para um registro de erro WHEA formatado como uma estrutura de WHEA_ERROR_RECORD.
[in] SectionType
Um GUID que especifica a estrutura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR a ser localizada no registro de erro de WHEA especificado.
[out] SectionDescriptor
O endereço de um ponteiro WHEA_ERROR_RECORD_SECTION_DESCRIPTOR.
Se a função WheaFindErrorRecordSection localizar a estrutura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR especificada, a função definirá o parâmetro SectionDescriptor para o endereço dessa estrutura dentro do registro de erro whea especificado.
[out, optional] SectionData
O endereço de um ponteiro PVOID.
Se a função WheaFindErrorRecordSection localizar a estrutura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR especificada, a função definirá o parâmetro SectionData para o endereço dos dados de erro de hardware associados a esse descritor dentro do registro de erro whea especificado.
Esse parâmetro é opcional e deve ser definido como NULL se um ponteiro para os dados de erro de hardware não for necessário.
Valor de retorno
WheaFindErrorRecordSection retorna um dos seguintes códigos NTSTATUS:
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | A estrutura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR especificada foi encontrada. |
| STATUS_NOT_FOUND | A estrutura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR especificada não foi encontrada. |
| STATUS_INVALID_PARAMETER | Os parâmetros de Registro, SectionType, ou SectionDescriptor foram definidos como NULL ou o registro de erro WHEA referenciado por meio do parâmetro de Registro é inválido. |
Observações
Se WheaFindErrorRecordSection retornar STATUS_SUCCESS, ele localizou a estrutura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR especificada por meio do parâmetro guid . WheaFindErrorRecordSection define o parâmetro SectionDescriptor para o endereço da estrutura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR localizada.
Além disso, se WheaFindErrorRecordSection retornar STATUS_SUCCESS e o chamador definir o parâmetro SectionData para o endereço de uma variável de ponteiro PVOID, a função atualizará o parâmetro com o endereço dos dados de erro de hardware associados à estrutura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR especificada.
O formato dos dados de erro de hardware depende do membro SectionType da estrutura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR referenciada por meio do parâmetro SectionDescriptor. Por exemplo, se o membro SectionType tiver o valor PROCESSOR_GENERIC_ERROR_SECTION_GUID, os dados de erro de hardware serão formatados como uma estrutura de WHEA_PROCESSOR_GENERIC_ERROR_SECTION.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte no Windows 7 e versões posteriores do Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ntddk.h (inclua Ntddk.h) |
| IRQL | IRQL <=DISPATCH_LEVEL |