Função PshedRegisterPlugin (ntddk.h)

  • Artigo

A função PshedRegisterPlugin registra um plug-in PSHED com o PSHED.

Sintaxe

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

Parâmetros

[in, out] Packet

Um ponteiro para uma estrutura de WHEA_PSHED_PLUGIN_REGISTRATION_PACKET inicializada que descreve as informações de registro do plug-in PSHED.

Retornar valor

PshedRegisterPlugin retorna um dos seguintes códigos NTSTATUS:

Código de retorno Descrição
STATUS_SUCCESS
 O plug-in PSHED foi registrado com êxito.
STATUS_INVALID_PARAMETER
 Os dados no pacote de registro fornecido são inválidos.

Comentários

Um plug-in PSHED chama a função PshedRegisterPlugin para se registrar no PSHED. Um plug-in PSHED normalmente chama essa função de dentro de sua função DriverEntry ou sua função AddDevice .

A partir de Windows 10, versão 1903 (WDK 10 versão 18362), uma V2 das interfaces PSHED-Plugin está disponível que permite que um plug-in seja removido e atualizado em um sistema em execução chamando a função PshedUnregisterPlugin. Como eles podem não ser registrados, os plug-ins V2 não podem especificar o sinalizador PshedFADiscovery (área funcional de descoberta) no membro FunctionalAreaMask da estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2. Para obter informações sobre como registrar um plug-in, consulte Registrando um plug-in PSHED. Para um plug-in V1, se você tentar cancelar o registro, poderá ocorrer uma verificação de bugs. É recomendável que você use um plug-in V2, se possível, que é o padrão atual.

Para registrar um plug-in V1 versus V2, use o struct correto. WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V1 para V1 e WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2 para V2.

Um plug-in V2 ainda pode adicionar fontes de erro conforme descrito em Usando WHEA em Windows 10 ou chamando WheaAddErrorSource e WheaRemoveErrorSource.

Um plug-in pode continuar a usar a área funcional de descoberta especificando WHEA_PLUGIN_REGISTRATION_PACKET_V1 como a versão de sua estrutura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2 .

Todos os retornos de chamada, em plug-ins V1 e V2, são chamados em um IRQL mínimo de DISPATCH_LEVEL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte no Windows Server 2008, Windows Vista SP1 e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho ntddk.h (inclua Ntddk.h)
Biblioteca Pshed.lib
DLL Pshed.dll
IRQL <=DISPATCH_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Confira também

AddDevice

DriverEntry

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET