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

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

Синтаксис

PSHED_PI_ENABLE_ERROR_SOURCE PshedPiEnableErrorSource;

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

Параметры

[in, out, optional] PluginContext

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

[in] ErrorSource

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

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

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

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

Замечания

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

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

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

Требования

Требование Ценность
целевая платформа Настольный
заголовка ntddk.h (include Ntddk.h)
IRQL IRQL = DISPATCH_LEVEL

См. также

DisableErrorSource

PshedRegisterPlugin

SetErrorSourceInfo

WHEA_ERROR_SOURCE_DESCRIPTOR

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET