функция обратного вызова PSHED_PI_DISABLE_ERROR_SOURCE (ntddk.h)

  • Статья

Функция обратного вызова DisableErrorSource подключаемого модуля PSHED отключает источник ошибок.

Синтаксис

PSHED_PI_DISABLE_ERROR_SOURCE PshedPiDisableErrorSource;

NTSTATUS PshedPiDisableErrorSource(
  [in, out, optional] PVOID PluginContext,
  [in]                PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource
)
{...}

Параметры

[in, out, optional] PluginContext

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

[in] ErrorSource

Указатель на структуру WHEA_ERROR_SOURCE_DESCRIPTOR , описывающую отключаемый источник ошибок.

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

Функция обратного вызова DisableErrorSource подключаемого модуля PSHED возвращает один из следующих кодов NTSTATUS:

Код возврата Описание
STATUS_SUCCESS Источник ошибки был успешно отключен.
STATUS_NOT_SUPPORTED Подключаемый модуль PSHED не поддерживает отключение указанного источника ошибок.
STATUS_UNSUCCESSFUL Произошла ошибка.

Комментарии

Подключаемый модуль PSHED, участвующий в системе управления версиями ошибок, задает элементы Callbacks.SetErrorSourceInfo, Callbacks.EnableErrorSource и Callbacks.DisableErrorSource структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET , указывающие на ее функции обратного вызова SetErrorSource,EnableErrorSource и DisableErrorSource , когда подключаемый модуль вызывает функцию PshedRegisterPlugin для регистрации в PSHED. Подключаемый модуль PSHED также должен установить флаг PshedFAErrorSourceControl в элементе FunctionalAreaMask структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

Ядро Windows вызывает PSHED для отключения источника ошибок в ответ на запрос на отключение источника ошибок от приложения управления WHEA. Если подключаемый модуль PSHED зарегистрирован для участия в системе управления версиями ошибок, PSHED вызывает функцию обратного вызова DisableErrorSource подключаемого модуля PSHED, чтобы предоставить подключаемым модулям PSHED возможность отключить источник ошибок. Если функция обратного вызова DisableErrorSource возвращает STATUS_NOT_SUPPORTED, PSHED отключит источник ошибок. В противном случае PSHED просто вернет возвращаемое значение, возвращаемое функцией обратного вызова DisableErrorSource .

Если подключаемый модуль PSHED успешно отключает источник ошибок, PSHED обновит структуру WHEA_ERROR_SOURCE_DESCRIPTOR от имени подключаемого модуля PSHED после вызова функции обратного вызова DisableErrorSource подключаемого модуля PSHED. Функция обратного вызова DisableErrorSource подключаемого модуля PSHED не должна изменять дескриптор источника ошибок.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть ntddk.h (включая Ntddk.h)
IRQL IRQL = DISPATCH_LEVEL

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

EnableErrorSource

PshedRegisterPlugin

SetErrorSourceInfo

WHEA_ERROR_SOURCE_DESCRIPTOR

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET