Função PshedRegisterPlugin (ntddk.h)
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.
Valor de retorno
PshedRegisterPlugin retorna um dos seguintes códigos NTSTATUS:
| Código de retorno | Descrição |
|---|---|
|
O plug-in PSHED foi registrado com êxito. |
|
Os dados no pacote de registro fornecido são inválidos. |
Observações
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 do 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 Registrar 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 o WHEA no Windows 10ou 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 |
|---|---|
| de cliente com suporte mínimo | Com suporte no Windows Server 2008, Windows Vista SP1 e versões posteriores do Windows. |
| da Plataforma de Destino | Universal |
| cabeçalho | ntddk.h (inclua Ntddk.h) |
| biblioteca | Pshed.lib |
| de DLL | Pshed.dll |
| IRQL | <=DISPATCH_LEVEL |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |