PSHED_PI_DISABLE_ERROR_SOURCE Rückruffunktion (ntddk.h)
Die Rückruffunktion DisableErrorSource eines PSHED-Plug-Ins deaktiviert eine Fehlerquelle.
Syntax
PSHED_PI_DISABLE_ERROR_SOURCE PshedPiDisableErrorSource;
NTSTATUS PshedPiDisableErrorSource(
[in, out, optional] PVOID PluginContext,
[in] PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource
)
{...}
Parameter
[in, out, optional] PluginContext
Ein Zeiger auf den Kontextbereich, der im Kontextelement der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur angegeben wurde, als das PSHED-Plug-In die PshedRegisterPlugin-Funktion aufgerufen hat, um sich bei der PSHED zu registrieren.
[in] ErrorSource
Ein Zeiger auf eine WHEA_ERROR_SOURCE_DESCRIPTOR-Struktur , die die deaktivierte Fehlerquelle beschreibt.
Rückgabewert
Die Rückruffunktion DisableErrorSource eines PSHED-Plug-Ins gibt einen der folgenden NTSTATUS-Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Fehlerquelle wurde erfolgreich deaktiviert. |
| STATUS_NOT_SUPPORTED | Das PSHED-Plug-In unterstützt das Deaktivieren der angegebenen Fehlerquelle nicht. |
| STATUS_UNSUCCESSFUL | Ein Fehler ist aufgetreten. |
Hinweise
Ein PSHED-Plug-In, das an der Fehlerquellensteuerung beteiligt ist, legt die Rückruffunktionen Callbacks.SetErrorSourceInfo, Callbacks.EnableErrorSource und Callbacks.DisableErrorSource der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur so fest, dass sie auf die Rückruffunktionen SetErrorSourceInfo, EnableErrorSource und DisableErrorSource verweisen, wenn das Plug-In die PshedRegisterPlugin-Funktion aufruft, um sich bei PSHED zu registrieren. Das PSHED-Plug-In muss auch das PshedFAErrorSourceControl-Flag im FunctionalAreaMask-Member der WHEA_PSHED_PLUGIN_REGISTRATION_PACKET-Struktur festlegen.
Der Windows-Kernel ruft den PSHED auf, um eine Fehlerquelle als Reaktion auf die Anforderung zur Deaktivierung einer Fehlerquelle durch eine WHEA-Verwaltungsanwendung zu deaktivieren. Wenn ein PSHED-Plug-In für die Teilnahme an der Fehlerquellensteuerung registriert ist, ruft PSHED die DisableErrorSource-Rückruffunktion des PSHED-Plug-Ins auf, um dem PSHED-Plug-In die Möglichkeit zu geben, die Fehlerquelle zu deaktivieren. Wenn die Rückruffunktion DisableErrorSource STATUS_NOT_SUPPORTED zurückgibt, deaktiviert PSHED die Fehlerquelle. Andernfalls gibt der PSHED nur den Rückgabewert zurück, der von der Rückruffunktion DisableErrorSource zurückgegeben wird.
Wenn das PSHED-Plug-In die Fehlerquelle erfolgreich deaktiviert, aktualisiert PSHED die WHEA_ERROR_SOURCE_DESCRIPTOR-Struktur im Namen des PSHED-Plug-Ins, nachdem der Aufruf der DisableErrorSource-Rückruffunktion des PSHED-Plug-Ins zurückgegeben wurde. Die Rückruffunktion DisableErrorSource eines PSHED-Plug-Ins sollte den Fehlerquellendeskriptor nicht ändern.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | ntddk.h (include Ntddk.h) |
| IRQL | IRQL = DISPATCH_LEVEL |