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 en 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 llamando 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 error 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

   
Cliente mínimo compatible Compatible con Windows Server 2008, Windows Vista SP1 y versiones posteriores de Windows.
Plataforma de destino Universal
Header 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