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 |