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

Функция 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, который является текущим значением по умолчанию.

Чтобы зарегистрировать подключаемый модуль версии 1 и 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 .

Все обратные вызовы в подключаемых модулях V1 и V2 вызываются как минимум irQL DISPATCH_LEVEL.

Требования

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

См. также

AddDevice

DriverEntry

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET