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 |
|---|---|
|
El complemento PSHED se registró correctamente. |
|
Los datos del paquete de registro proporcionado no son válidos. |
Observaciones
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 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, consulte Registro de 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 Using WHEA on Windows 10, or by calling WheaAddErrorSource and WheaRemoveErrorSource.
Un complemento puede seguir usando el área funcional de detección especificando WHEA_PLUGIN_REGISTRATION_PACKET_V1 como 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 | Valor |
|---|---|
| cliente mínimo admitido | Compatible con Windows Server 2008, Windows Vista SP1 y versiones posteriores de Windows. |
| de la plataforma de destino de | Universal |
| encabezado de | ntddk.h (incluya Ntddk.h) |
| biblioteca de | Pshed.lib |
| DLL de | Pshed.dll |
| irQL | <=DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |