PSHED_PI_INJECT_ERROR - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ntddk.h
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
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
A PSHED plug-in's InjectError callback function injects an error into the hardware platform.
PluginContext [in, out, optional]A pointer to the context area that was specified in the Context member of the WHEA_PSHED_PLUGIN_REGISTRATION_PACKET structure when the PSHED plug-in called the PshedRegisterPlugin function to register itself with the PSHED.
ErrorType [in]The type of error to be injected into the hardware platform. Possible values are:
A correctable processor error.
An uncorrectable nonfatal processor error.
An uncorrectable fatal processor error.
A correctable memory error.
An uncorrectable nonfatal memory error.
An uncorrectable fatal memory error.
A correctable PCI Express error.
An uncorrectable nonfatal PCI Express error.
An uncorrectable fatal PCI Express error.
A correctable platform error.
An uncorrectable nonfatal platform error.
An uncorrectable fatal platform error.
Parameter1 [in]A generic parameter that contains additional data that is passed by the WHEA management application that is injecting the error.
Parameter2 [in]A generic parameter that contains additional data that is passed by the WHEA management application that is injecting the error.
Parameter3 [in]A generic parameter that contains additional data that is passed by the WHEA management application that is injecting the error.
Parameter4 [in]A generic parameter that contains additional data that is passed by the WHEA management application that is injecting the error.
A PSHED plug-in's InjectError callback function returns one of the following NTSTATUS codes:
| Return code | Description |
|---|---|
| STATUS_SUCCESS | The error was successfully injected into the hardware platform. |
| STATUS_UNSUCCESSFUL | An error occurred. For injected errors that are fatal or otherwise unrecoverable, this callback function might not return before the operating system generates a bug check in response to the error condition. |
A PSHED plug-in that participates in error injection sets the Callbacks.GetInjectionCapabilities and Callbacks.InjectError members of the WHEA_PSHED_PLUGIN_REGISTRATION_PACKET structure to point to its GetInjectionCapabilities and InjectError callback functions when the plug-in calls the PshedRegisterPlugin function to register itself with the PSHED. The PSHED plug-in must also set the PshedFAErrorInjection flag in the FunctionalAreaMask member of the WHEA_PSHED_PLUGIN_REGISTRATION_PACKET structure.
When a WHEA management application makes a request to inject a hardware error, the Windows kernel calls into the PSHED to inject the error into the hardware platform. If a PSHED plug-in is registered to participate in error injection, the PSHED calls the PSHED plug-in's InjectError callback function to perform the error injection operation.
The WHEA management application that is injecting the error can pass additional error-specific data to the PSHED plug-in's InjectError callback function by using parameters Parameter1 through Parameter4. For example, on Itanium-based systems, some of the error injection operations require an accompanying address. In this situation, the WHEA management application can pass the address to the PSHED plug-in's InjectError callback function using one of these parameters.
WHEA_PSHED_PLUGIN_REGISTRATION_PACKET