функция обратного вызова PSHED_PI_ENABLE_ERROR_SOURCE (ntddk.h)
Функция обратного вызова EnableErrorSource подключаемого модуля PSHED включает источник ошибок.
Синтаксис
PSHED_PI_ENABLE_ERROR_SOURCE PshedPiEnableErrorSource;
NTSTATUS PshedPiEnableErrorSource(
[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 , описывающую включенный источник ошибок.
Возвращаемое значение
Функция обратного вызова EnableErrorSource подключаемого модуля 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, чтобы включить каждый из источников ошибок, которые были зарегистрированы во время обнаружения источников ошибок. Ядро Windows также вызывает PSHED, чтобы включить источник ошибок в ответ на запрос на включение источника ошибок от приложения управления WHEA. Если подключаемый модуль PSHED зарегистрирован для участия в системе управления версиями ошибок, PSHED вызывает функцию обратного вызова EnableErrorSource подключаемого модуля PSHED, чтобы предоставить подключаемым модулям PSHED возможность включить источник ошибок. Если функция обратного вызова EnableErrorSource возвращает STATUS_NOT_SUPPORTED, PSHED включает источник ошибок. В противном случае PSHED просто вернет возвращаемое значение, возвращаемое функцией обратного вызова EnableErrorSource .
Если подключаемый модуль PSHED успешно включает источник ошибок, PSHED обновит структуру WHEA_ERROR_SOURCE_DESCRIPTOR от имени подключаемого модуля PSHED после вызова функции обратного вызова EnableErrorSource подключаемого модуля PSHED. Функция обратного вызова EnableErrorSource подключаемого модуля PSHED не должна изменять дескриптор источника ошибок.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | ntddk.h (включая Ntddk.h) |
| IRQL | IRQL = DISPATCH_LEVEL |