Funzione PshedRegisterPlugin (ntddk.h)
La funzione PshedRegisterPlugin registra un plug-in PSHED con PSHED.
Sintassi
NTPSHEDAPI NTSTATUS PshedRegisterPlugin(
[in, out] PWHEA_PSHED_PLUGIN_REGISTRATION_PACKET Packet
);
Parametri
[in, out] Packet
Puntatore a una struttura di WHEA_PSHED_PLUGIN_REGISTRATION_PACKET inizializzata che descrive le informazioni di registrazione del plug-in PSHED.
Valore restituito
PshedRegisterPlugin restituisce uno dei codici NTSTATUS seguenti:
Codice restituito | Descrizione |
---|---|
|
Il plug-in PSHED è stato registrato correttamente. |
|
I dati nel pacchetto di registrazione fornito non sono validi. |
Commenti
Un plug-in PSHED chiama la funzione PshedRegisterPlugin per registrarsi con PSHED. Un plug-in PSHED chiama in genere questa funzione dall'interno della funzione DriverEntry o dalla relativa funzione AddDevice .
A partire da Windows 10, versione 1903 (WDK 10 versione 18362), è disponibile una versione 2 delle interfacce PSHED-Plugin che consente di rimuovere e aggiornare un plug-in in un sistema in esecuzione chiamando la funzione PshedUnregisterPlugin. Poiché possono essere annullate, i plug-in V2 non possono specificare il flag PshedFADiscovery (area funzionale di individuazione) nel membro FunctionalAreaMask della struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2. Per informazioni sulla registrazione di un plug-in, vedere Registrazione di un plug-in PSHED. Per un plug-in V1, se si tenta di annullare la registrazione, potrebbe verificarsi un controllo di bug. Se possibile, è consigliabile usare un plug-in V2, ovvero l'impostazione predefinita corrente.
Per registrare un plug-in V1 e V2, usare lo struct corretto. WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V1 per V1 e WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2 per V2.
Un plug-in V2 può comunque aggiungere origini di errore come descritto in Uso di WHEA in Windows 10 o chiamando WheaAddErrorSource e WheaRemoveErrorSource.
Un plug-in può continuare a usare l'area funzionale di individuazione specificando WHEA_PLUGIN_REGISTRATION_PACKET_V1 come versione della relativa struttura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2 .
Tutti i callback, nei plug-in V1 e V2, vengono chiamati almeno IRQL di DISPATCH_LEVEL.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Supportato in Windows Server 2008, Windows Vista SP1 e versioni successive di Windows. |
Piattaforma di destinazione | Universale |
Intestazione | ntddk.h (include Ntddk.h) |
Libreria | Pshed.lib |
DLL | Pshed.dll |
IRQL | <=DISPATCH_LEVEL |
Regole di conformità DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |