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

Artigo
04/21/2023

A função de retorno de chamada WriteErrorRecord de um plug-in PSHED grava um registro de erro no armazenamento de dados persistente do sistema.

Sintaxe

PSHED_PI_WRITE_ERROR_RECORD PshedPiWriteErrorRecord;

NTSTATUS PshedPiWriteErrorRecord(
  [in, out, optional] PVOID PluginContext,
  [in]                ULONG Flags,
  [in]                ULONG RecordLength,
  [in]                PWHEA_ERROR_RECORD ErrorRecord
)
{...}

Parâmetros

[in, out, optional] PluginContext

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

[in] Flags

Uma combinação or'ed bit-wise de sinalizadores que afetam a operação de gravação. Um possível sinalizador é:

WHEA_WRITE_FLAG_DUMMY

A operação de gravação é uma operação de gravação fictícia. Nenhum dado deve ser gravado no armazenamento de dados persistente do sistema.

[in] RecordLength

O tamanho, em bytes, do registro de erro apontado pelo parâmetro ErrorRecord .

[in] ErrorRecord

Um ponteiro para uma estrutura WHEA_ERROR_RECORD que descreve o registro de erro que está sendo gravado no armazenamento de dados persistente do sistema.

Retornar valor

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

Código de retorno	Descrição
STATUS_SUCCESS	O registro de erro foi gravado com êxito no armazenamento de dados persistente do sistema.
STATUS_UNSUCCESSFUL	Ocorreu um erro.

Comentários

Um plug-in PSHED que participa da persistência de registro de erro define o Callbacks.WriteErrorRecord, Os membros Callbacks.ReadErrorRecord e Callbacks.ClearErrorRecord da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para apontar para suas funções de retorno de chamada WriteErrorRecord, ReadErrorRecord e ClearErrorRecord quando o plug-in chama a função PshedRegisterPlugin para se registrar no PSHED. O plug-in PSHED também deve definir o sinalizador PshedFAErrorRecordPersistence no membro FunctionalAreaMask da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET .

O kernel do Windows chama o PSHED para gravar um registro de erro no armazenamento de dados persistente do sistema sempre que houver uma condição de erro fatal ou irrecuperável para que o registro de erro seja preservado enquanto o sistema é reiniciado. Se um plug-in PSHED estiver registrado para participar da persistência de registro de erro, o PSHED chamará a função de retorno de chamada WriteErrorRecord do plug-in PSHED para executar a operação de gravação. O mecanismo usado para gravar o registro de erro no armazenamento de dados persistente do sistema é específico da plataforma.