PSHED_PI_CLEAR_ERROR_STATUS função de retorno de chamada (ntddk.h)

Artigo
02/07/2025

A função de retorno de chamada ClearErrorStatus de um plug-in PSHED limpa todos os registros de status de erro específicos da plataforma para uma condição de erro de hardware corrigida.

Sintaxe

PSHED_PI_CLEAR_ERROR_STATUS PshedPiClearErrorStatus;

NTSTATUS PshedPiClearErrorStatus(
  [in, out, optional] PVOID PluginContext,
  [in]                PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource,
  [in]                ULONG BufferLength,
  [in]                PWHEA_ERROR_RECORD ErrorRecord
)
{...}

Parâmetros

[in, out, optional] PluginContext

Um ponteiro para a área de contexto especificada no Context membro da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET quando o plug-in PSHED chamou a função PshedRegisterPlugin para se registrar no PSHED.

[in] ErrorSource

Um ponteiro para uma estrutura de WHEA_ERROR_SOURCE_DESCRIPTOR que descreve a fonte de erro que relatou o erro de hardware.

[in] BufferLength

O tamanho, em bytes, do buffer apontado pelo parâmetro ErrorRecord.

[in] ErrorRecord

Um ponteiro para uma estrutura de WHEA_ERROR_RECORD que descreve um registro de erro. O registro de erro descreve a condição de erro de hardware corrigida para a qual os registros de status de erro específicos da plataforma estão sendo limpos.

Valor de retorno

A função de retorno de chamada ClearErrorStatus de um plug-in PSHED retorna um dos seguintes códigos NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	Os registros de status de erro específicos da plataforma para a condição de erro de hardware corrigida foram limpos com êxito.
STATUS_NOT_SUPPORTED	O plug-in PSHED não dá suporte à fonte de erro especificada.
STATUS_UNSUCCESSFUL	Ocorreu um erro.

Observações

Um plug-in PSHED que participa da recuperação de informações de erro define os Callbacks.RetrieveErrorInfo, Callbacks.FinalizeErrorRecorde Callbacks.ClearErrorStatus membros da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para apontar para sua estrutura RetrieveErrorInfo, FinalizeErrorRecorde clearErrorStatus funções de retorno de chamada quando o plug-in chama a função PshedRegisterPlugin para se registrar no PSHED. O plug-in PSHED também deve definir o sinalizador PshedFAErrorInfoRetrieval no membro FunctionalAreaMask da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

Para condições de erro de hardware corrigidas, o kernel do Windows chama o PSHED para limpar os registros de status de erro da fonte de erro como a etapa final do processamento do erro. Se um plug-in PSHED estiver registrado para participar da recuperação de informações de erro, o PSHED chamará o plug-in PSHED ClearErrorStatus função de retorno de chamada para que o plug-in PSHED possa limpar os registros de status de erro específicos da plataforma adicionais.