PSHED_PI_SET_ERROR_SOURCE_INFO 콜백 함수(ntddk.h)

아티클
04/21/2023

PSHED 플러그 인의 SetErrorSourceInfo 콜백 함수는 오류 원본을 구성합니다.

구문

PSHED_PI_SET_ERROR_SOURCE_INFO PshedPiSetErrorSourceInfo;

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

매개 변수

[in, out, optional] PluginContext

PSHED 플러그 인이 PshedRegisterPlugin 함수를 호출하여 PSHED에 등록할 때 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 구조의 컨텍스트 멤버에 지정된 컨텍스트 영역에 대한 포인터입니다.

[in] ErrorSource

구성 중인 오류 원본을 설명하는 WHEA_ERROR_SOURCE_DESCRIPTOR 구조체에 대한 포인터입니다.

반환 값

PSHED 플러그 인의 SetErrorSourceInfo 콜백 함수는 다음 NTSTATUS 코드 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	오류 원본이 성공적으로 구성되었습니다.
STATUS_NOT_SUPPORTED	PSHED 플러그 인은 지정된 오류 원본의 구성을 지원하지 않습니다.
STATUS_UNSUCCESSFUL	오류가 발생했습니다.

설명

오류 소스 제어에 참여하는 PSHED 플러그 인은 Callbacks.SetErrorSourceInfo를 설정합니다. 플러그 인이 PshedRegisterPlugin 함수를 호출하여 PSHED에 등록할 때 SetErrorSourceInfo, EnableErrorSource 및 DisableErrorSource 콜백 함수를 가리키는 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 구조체의 Callbacks.EnableErrorSource 및 Callbacks.DisableErrorSource 멤버입니다. 또한 PSHED 플러그 인은 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 구조체의 FunctionalAreaMask 멤버에서 PshedFAErrorSourceControl 플래그를 설정해야 합니다.

Windows 커널은 PSHED를 호출하여 WHEA 관리 애플리케이션의 오류 원본 구성 요청에 대한 응답으로 오류 원본을 구성합니다. PSHED 플러그 인이 오류 소스 제어에 참여하도록 등록된 경우 PSHED 플러그 인의 SetErrorSourceInfo 콜백 함수를 호출하여 PSHED 플러그 인에 오류 원본 구성 작업을 수행할 수 있는 기회를 제공합니다. 오류 원본 구성 데이터는 ErrorSource 매개 변수가 가리키는 WHEA_ERROR_SOURCE_DESCRIPTOR 구조에 포함됩니다.

PSHED 플러그 인이 지정된 오류 원본의 구성을 지원하지 않는 경우 SetErrorSourceInfo 콜백 함수는 STATUS_NOT_SUPPORTED 반환합니다. 이 경우 PSHED는 요청된 오류 원본 구성 작업을 수행합니다.

PSHED 플러그 인이 지정된 오류 원본의 구성을 지원하는 경우 SetErrorSourceInfo 콜백 함수는 오류 원본의 구성 데이터를 레지스트리, 시스템의 BIOS 테이블 또는 오류 원본에 사용할 수 있는 다른 형태의 비휘발성 데이터 스토리지에 저장해야 합니다. 오류 원본의 구성 데이터를 저장하기 위해 오류 원본에서 사용하는 특정 형식의 비휘발성 데이터 스토리지는 구현에 따라 다릅니다. SetErrorSourceInfo 콜백 함수는 다음에 시스템을 다시 시작할 때 구성 변경 내용이 적용되도록 구성 데이터를 오류 원본에 적용해야 합니다. 시스템을 다시 시작하면 PSHED 플러그 인은 오류 원본 검색 중에 오류 원본에 대한 새 오류 원본 구성 데이터를 운영 체제에 보고해야 합니다.