PSHED_PI_ENABLE_ERROR_SOURCE 콜백 함수(ntddk.h)

아티클
02/29/2024

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

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

[in] ErrorSource

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

반환 값

PSHED 플러그 인의 EnableErrorSource 콜백 함수는 다음 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를 호출하여 오류 원본 검색 중에 보고된 각 오류 원본을 사용하도록 설정합니다. 또한 Windows 커널은 PSHED를 호출하여 WHEA 관리 애플리케이션의 오류 원본 사용 요청에 대한 응답으로 오류 원본을 사용하도록 설정합니다. PSHED 플러그 인이 오류 소스 제어에 참여하도록 등록된 경우 PSHED 플러그 인의 EnableErrorSource 콜백 함수를 호출하여 PSHED 플러그 인에 오류 원본을 사용하도록 설정할 수 있는 기회를 제공합니다. EnableErrorSource 콜백 함수가 STATUS_NOT_SUPPORTED 반환하면 PSHED에서 오류 원본을 사용하도록 설정합니다. 그렇지 않으면 PSHED는 EnableErrorSource 콜백 함수에서 반환하는 반환 값만 반환합니다.

PSHED 플러그 인이 오류 원본을 성공적으로 사용하도록 설정하면 PSHED 플러그 인의 EnableErrorSource 콜백 함수가 반환된 후 PSHED 플러그 인을 대신하여 PSHED 구조체가 WHEA_ERROR_SOURCE_DESCRIPTOR 업데이트됩니다. PSHED 플러그 인의 EnableErrorSource 콜백 함수는 오류 원본 설명자를 수정하면 안 됩니다.