Función PshedRegisterPlugin (ntddk.h)

La función PshedRegisterPlugin registra un complemento PSHED con el PSHED.

Sintaxis

NTPSHEDAPI NTSTATUS PshedRegisterPlugin(
  [in, out] PWHEA_PSHED_PLUGIN_REGISTRATION_PACKET Packet
);

Parámetros

[in, out] Packet

Puntero a una estructura de WHEA_PSHED_PLUGIN_REGISTRATION_PACKET inicializada que describe la información de registro del complemento PSHED.

Valor devuelto

PshedRegisterPlugin devuelve uno de los siguientes códigos NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	El complemento PSHED se registró correctamente.
STATUS_INVALID_PARAMETER	Los datos del paquete de registro proporcionado no son válidos.

Comentarios

Un complemento PSHED llama a la función PshedRegisterPlugin para registrarse con el PSHED. Un complemento PSHED normalmente llama a esta función desde su función DriverEntry o su función AddDevice .

A partir de Windows 10, versión 1903 (WDK 10 versión 18362), hay disponible una versión V2 de las interfaces de PSHED-Plugin que permite quitar y actualizar un complemento en un sistema en ejecución mediante una llamada a la función PshedUnregisterPlugin. Dado que se pueden anular el registro, los complementos V2 no pueden especificar la marca PshedFADiscovery (área funcional de detección) en el miembro FunctionalAreaMask de la estructura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2. Para obtener información sobre cómo registrar un complemento, consulta Registrar un complemento PSHED. Para un complemento V1, si intenta anular el registro, puede producirse una comprobación de errores. Se recomienda usar un complemento V2 si es posible, que es el valor predeterminado actual.

Para registrar un complemento V1 frente a V2, use la estructura correcta. WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V1 para V1 y WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2 para V2.

Un complemento V2 todavía puede agregar orígenes de errores como se describe en Uso de WHEA en Windows 10, o llamando a WheaAddErrorSource y WheaRemoveErrorSource.

Un complemento puede seguir usando el área funcional de detección especificando WHEA_PLUGIN_REGISTRATION_PACKET_V1 como la versión de su estructura de WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2 .

Todas las devoluciones de llamada, en los complementos V1 y V2, se llaman como mínimo IRQL de DISPATCH_LEVEL.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con Windows Server 2008, Windows Vista SP1 y versiones posteriores de Windows.
Plataforma de destino	Universal
Encabezado	ntddk.h (incluya Ntddk.h)
Library	Pshed.lib
Archivo DLL	Pshed.dll
IRQL	<=DISPATCH_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte también

AddDevice

DriverEntry

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET