PSHED_PI_GET_INJECTION_CAPABILITIES funzione di callback (ntddk.h)

Articolo
02/29/2024

Una funzione di callback Get AnywherectionCapabilities di un plug-in PSHED 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 membro Context della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET quando il plug-in PSHED ha chiamato la funzione PshedRegisterPlugin 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

La funzione di callback Get AnywherectionCapabilities di un plug-in PSHED 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.

Commenti

Un plug-in PSHED che partecipa all'inserimento degli errori imposta i membri Callbacks.GetMakectionCapabilities e Callbacks.InjectError della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET in modo che puntino alle funzioni di callback GetJectEctionCapabilities e InjectError 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 .

Il kernel di Windows chiama pshed per recuperare informazioni sui tipi di errori hardware che possono essere inseriti nella piattaforma hardware in risposta a una richiesta 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 la funzione di callback GetChangectionCapabilities del plug-in PSHED per recuperare informazioni sui tipi aggiuntivi di errori hardware che possono essere inseriti nella piattaforma hardware.