Condividi tramite


PSHED_PI_INJECT_ERROR funzione di callback (ntddk.h)

La funzione di callback injectError di PSHED inserisce un errore nella piattaforma hardware.

Sintassi

PSHED_PI_INJECT_ERROR PshedPiInjectError;

NTSTATUS PshedPiInjectError(
  [in, out, optional] PVOID PluginContext,
  [in]                ULONGLONG ErrorType,
  [in]                ULONGLONG Parameter1,
  [in]                ULONGLONG Parameter2,
  [in]                ULONGLONG Parameter3,
  [in]                ULONGLONG Parameter4
)
{...}

Parametri

[in, out, optional] PluginContext

Puntatore all'area di contesto specificata nel membro Contesto della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET quando il plug-in PSHED ha chiamato la funzione PshedRegisterPlugin per registrarsi con PSHED.

[in] ErrorType

Tipo di errore da inserire nella piattaforma hardware. I valori possibili sono:

INJECT_ERRTYPE_PROCESSOR_CORRECTABLE

Errore corretto del processore.

INJECT_ERRTYPE_PROCESSOR_UNCORRECTABLENONFATAL

Errore non irreversibile del processore non irreversibile.

INJECT_ERRTYPE_PROCESSOR_UNCORRECTABLEFATAL

Errore irreversibile del processore non corretto.

INJECT_ERRTYPE_MEMORY_CORRECTABLE

Errore di memoria corretto.

INJECT_ERRTYPE_MEMORY_UNCORRECTABLENONFATAL

Errore di memoria non irreversibile.

INJECT_ERRTYPE_MEMORY_UNCORRECTABLEFATAL

Errore di memoria irreversibile non corretto.

INJECT_ERRTYPE_PCIEXPRESS_CORRECTABLE

Errore PCI Express corretto.

INJECT_ERRTYPE_PCIEXPRESS_UNCORRECTABLENONFATAL

Errore PCI Express non irreversibile.

INJECT_ERRTYPE_PCIEXPRESS_UNCORRECTABLEFATAL

Errore PCI Express irreversibile non corretto.

INJECT_ERRTYPE_PLATFORM_CORRECTABLE

Errore della piattaforma corretto.

INJECT_ERRTYPE_PLATFORM_UNCORRECTABLENONFATAL

Errore non irreversibile della piattaforma non irreversibile.

INJECT_ERRTYPE_PLATFORM_UNCORRECTABLEFATAL

Errore irreversibile della piattaforma non corretto.

[in] Parameter1

Parametro generico che contiene dati aggiuntivi passati dall'applicazione di gestione WHEA che inserisce l'errore.

[in] Parameter2

Parametro generico che contiene dati aggiuntivi passati dall'applicazione di gestione WHEA che inserisce l'errore.

[in] Parameter3

Parametro generico che contiene dati aggiuntivi passati dall'applicazione di gestione WHEA che inserisce l'errore.

[in] Parameter4

Parametro generico che contiene dati aggiuntivi passati dall'applicazione di gestione WHEA che inserisce l'errore.

Valore restituito

Una funzione di callback di InjectError di PSHED restituisce uno dei codici NTSTATUS seguenti:

Codice restituito Descrizione
STATUS_SUCCESS L'errore è stato inserito correttamente nella piattaforma hardware.
STATUS_UNSUCCESSFUL Si è verificato un errore. Per gli errori inseriti irreversibili o altrimenti non recuperabili, questa funzione di callback potrebbe non restituire prima che il sistema operativo generi un controllo di bug in risposta alla condizione di errore.

Commenti

Un plug-in PSHED che partecipa all'inserimento degli errori imposta le funzioni callbacks.GetChangectionCapabilities e Callbacks.InjectError della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET per puntare alle funzioni GetChangectionCapabilities e InjectError callback quando il plug-in chiama la funzione PshedRegisterPlugin per registrarsi con PSHED. Il plug-in PSHED deve anche impostare il flag PshedFAErrorChangection nel membro FunctionalAreaMask della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

Quando un'applicazione di gestione WHEA effettua una richiesta per inserire un errore hardware, il kernel di Windows chiama il psHED per inserire l'errore nella piattaforma hardware. Se un plug-in PSHED viene registrato per partecipare all'inserimento degli errori, il PSHED chiama la funzione di callback di InjectError del plug-in PSHED per eseguire l'operazione di inserimento degli errori.

L'applicazione di gestione WHEA che inserisce l'errore può passare dati specifici degli errori aggiuntivi alla funzione di callback injectError del plug-in PSHED usando parametri Parameter1 tramite Parameter4. Ad esempio, nei sistemi basati su Itanium, alcune delle operazioni di inserimento degli errori richiedono un indirizzo di accompagnamento. In questo caso, l'applicazione di gestione WHEA può passare l'indirizzo alla funzione di callback di InjectError del plug-in PSHED usando uno di questi parametri.

Requisiti

Requisito Valore
Client minimo supportato Supportato in Windows Server 2008, Windows Vista SP1 e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione ntddk.h (include Ntddk.h)
IRQL IRQL = DISPATCH_LEVEL

Vedi anche

GetSignectionCapabilities

PshedRegisterPlugin

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET