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