PSHED_PI_GET_INJECTION_CAPABILITIES funzione di callback (ntddk.h)

Articolo
02/07/2025

Un plug-in PSHED GetMakectionCapabilities funzione di callback restituisce un'unione di funzionalità di inserimento degli errori che descrive i tipi di errori hardware che possono essere inseriti nella piattaforma hardware.

Sintassi

PSHED_PI_GET_INJECTION_CAPABILITIES PshedPiGetInjectionCapabilities;

NTSTATUS PshedPiGetInjectionCapabilities(
  [in, out, optional] PVOID PluginContext,
  [out]               PWHEA_ERROR_INJECTION_CAPABILITIES Capabilities
)
{...}

Parametri

[in, out, optional] PluginContext

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

[out] Capabilities

Puntatore a un'unione WHEA_ERROR_INJECTION_CAPABILITIES. Questa unione riceve i dati che descrivono i tipi di errori hardware che possono essere inseriti nella piattaforma hardware.

Valore restituito

Un plug-in PSHED Get IisectionCapabilities funzione di callback restituisce uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	I dati che descrivono i tipi di errori hardware che possono essere inseriti nella piattaforma hardware sono stati restituiti correttamente nell'unione WHEA_ERROR_INJECTION_CAPABILITIES a cui punta il parametro Capabilities.
STATUS_UNSUCCESSFUL	Si è verificato un errore.

Osservazioni

Un plug-in PSHED che partecipa all'inserimento degli errori imposta i membri Callbacks.GetJectectionCapabilities e Callbacks.InjectError della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET in modo che punti al relativo GetJectectionCapabilities e Funzioni di callback injectError quando il plug-in chiama la funzione PshedRegisterPlugin per registrarsi con pshed. Il plug-in PSHED deve anche impostare il flag di pshedFAError In FunctionalAreaMask della struttura di WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

Il kernel di Windows chiama pshed per recuperare informazioni sui tipi di errori hardware che possono essere inseriti nella piattaforma hardware in risposta a un'indagine sulle funzionalità di inserimento degli errori da parte di un'applicazione di gestione WHEA. Se un plug-in PSHED viene registrato per partecipare all'inserimento degli errori, PSHED chiama il plug-in PSHED Get StackectionCapabilities funzione di callback per recuperare informazioni sui tipi aggiuntivi di errori hardware che possono essere inseriti nella piattaforma hardware.