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

Um plug-in PSHED WriteErrorRecord função de retorno de chamada 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 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] 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 de WHEA_ERROR_RECORD que descreve o registro de erro que está sendo gravado no armazenamento de dados persistente do sistema.

Valor de retorno

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

Observações

Um plug-in PSHED que participa da persistência de registro de erro define o Callbacks.WriteErrorRecord, Callbacks.ReadErrorRecord e Callbacks.ClearErrorRecord membros da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para apontar para sua WriteErrorRecord, ReadErrorRecord e funções de retorno de chamada 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 functionalAreaMask membro 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 do registro de erro, o PSHED chamará o plug-in PSHED WriteErrorRecord função de retorno de chamada 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.

Requisitos

Consulte também

ClearErrorRecord

PshedRegisterPlugin

ReadErrorRecord

WHEA_ERROR_RECORD

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET