Compartilhar via


Função WheaFindNextErrorRecordSection (ntddk.h)

A função WheaFindNextErrorRecordSection permite que um chamador examine iterativamente as seções de registro de erro whea em um registro de erro WHEA. Cada seção de registro de erro é formatada como uma estrutura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR.

Sintaxe

NTSTATUS WheaFindNextErrorRecordSection(
  [in]            PWHEA_ERROR_RECORD                    Record,
  [in, out]       ULONG                                 *Context,
  [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, out] Context

Um ponteiro para uma variável ULONG que mantém o estado atual da pesquisa.

Essa variável deve ser inicializada como zero antes da primeira chamada para a função WheaFindNextErrorRecordSection.

[out] SectionDescriptor

O endereço de um ponteiro WHEA_ERROR_RECORD_SECTION_DESCRIPTOR.

Se a função WheaFindNextErrorRecordSection localizar a próxima estrutura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR dentro do registro de erro whea especificado, 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 WheaFindNextErrorRecordSection localizar a próxima estrutura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR dentro do registro de erro whea especificado, a função definirá o parâmetro SectionData para o endereço dos dados de erro de hardware associados a esse descritor.

Esse parâmetro é opcional e deve ser definido como NULL se um ponteiro para os dados da seção de registro de erro não for necessário.

Valor de retorno

WheaFindNextErrorRecordSection retorna um dos seguintes códigos NTSTATUS:

Código de retorno Descrição
STATUS_SUCCESS A estrutura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR seguinte foi encontrada.
STATUS_NOT_FOUND A estrutura WHEA_ERROR_RECORD_SECTION_DESCRIPTOR seguinte não foi encontrada.
STATUS_INVALID_PARAMETER Os parâmetros Record, SectionType, ou SectionDescriptor foram definidos como NULL ou os dados WHEA_ERROR_RECORD referenciados por meio do parâmetro de Registro são inválidos.

Observações

Se o parâmetro de Contexto for definido como 0, WheaFindNextErrorRecordSection retornará um ponteiro para a primeira estrutura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR dentro de um registro de erro do WHEA . WheaFindNextErrorRecordSection também atualizará o parâmetro Context com informações de estado relacionadas à WHEA_ERROR_RECORD_SECTION_DESCRIPTOR retornada por meio do parâmetro SectionDescriptor.

Nas chamadas subsequentes para WheaFindNextErrorRecordSection, a função retorna a próxima estrutura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR (se disponível) no registro de erro whea. Se a função localizar a próxima estrutura de WHEA_ERROR_RECORD_SECTION_DESCRIPTOR, ela atualizará o parâmetro contexto. Caso contrário, a função retornará STATUS_NOT_FOUND.

Para localizar a primeira WHEA_ERROR_RECORD_SECTION_DESCRIPTOR dentro do de registro de erro deWHEA especificado, o chamador deve definir a variável, cujo endereço é passado no parâmetro de Contexto, como 0 antes da chamada. Depois disso, o chamador não deve modificar o valor da variável ao localizar o próximo WHEA_ERROR_RECORD_SECTION_DESCRIPTOR por meio de chamadas subsequentes para WheaFindNextErrorRecordSection.

Além disso, se WheaFindNextErrorRecordSection 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

Consulte também

de registro de erro

WHEA_ERROR_PACKET

WHEA_ERROR_RECORD

WHEA_ERROR_RECORD_SECTION_DESCRIPTOR