Функция PshedRegisterPlugin (ntddk.h)

Статья
08/07/2023

Функция PshedRegisterPlugin регистрирует подключаемый модуль PSHED с помощью PSHED.

Синтаксис

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

Параметры

[in, out] Packet

Указатель на инициализированную структуру WHEA_PSHED_PLUGIN_REGISTRATION_PACKET , которая описывает сведения о регистрации подключаемого модуля PSHED.

Возвращаемое значение

PshedRegisterPlugin возвращает один из следующих кодов NTSTATUS:

Код возврата	Описание
STATUS_SUCCESS	Подключаемый модуль PSHED успешно зарегистрирован.
STATUS_INVALID_PARAMETER	Недопустимые данные в предоставленном пакете регистрации.

Подключаемый модуль PSHED вызывает функцию PshedRegisterPlugin для регистрации в PSHED. Подключаемый модуль PSHED обычно вызывает эту функцию из функции DriverEntry или Функции AddDevice .

Начиная с Windows 10 версии 1903 (WDK 10 версии 18362), доступна версия 2 интерфейсов PSHED-Plugin, которая позволяет удалять и обновлять подключаемый модуль в работающей системе путем вызова функции PshedUnregisterPlugin. Так как их можно отменить регистрацию, подключаемые модули версии 2 не могут указывать флаг PshedFADiscovery (функциональная область обнаружения) в элементе FunctionalAreaMask структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2. Сведения о регистрации подключаемого модуля см. в разделе Регистрация подключаемого модуля PSHED. При попытке отменить регистрацию подключаемого модуля версии 1 может возникнуть ошибка. По возможности рекомендуется использовать подключаемый модуль версии 2, который является текущим значением по умолчанию.

Чтобы зарегистрировать подключаемый модуль V1 и V2, используйте правильную структуру. WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V1 для версии 1 и WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2 для версии 2.

Подключаемый модуль версии 2 по-прежнему может добавлять источники ошибок, как описано в разделе Использование WHEA на Windows 10 или путем вызова WheaAddErrorSource и WheaRemoveErrorSource.

Подключаемый модуль может продолжать использовать функциональную область обнаружения, указав WHEA_PLUGIN_REGISTRATION_PACKET_V1 в качестве версии своей WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2 структуры.

Все обратные вызовы в подключаемых модулях версии 1 и 2 вызываются с минимальным значением IRQL DISPATCH_LEVEL.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в Windows Server 2008, Windows Vista с пакетом обновления 1 (SP1) и более поздних версиях Windows.
Целевая платформа	Универсальное
Верхняя часть	ntddk.h (включая Ntddk.h)
Библиотека	Pshed.lib
DLL	Pshed.dll
IRQL	<=DISPATCH_LEVEL
Правила соответствия DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

См. также раздел

AddDevice

DriverEntry

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET