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 |