PSHED_PI_CLEAR_ERROR_RECORD 콜백 함수(ntddk.h)

아티클
02/26/2024

PSHED 플러그 인의 ClearErrorRecord 콜백 함수는 시스템의 영구 데이터 스토리지에서 지정된 오류 레코드를 지웁니다.

구문

PSHED_PI_CLEAR_ERROR_RECORD PshedPiClearErrorRecord;

NTSTATUS PshedPiClearErrorRecord(
  [in, out, optional] PVOID PluginContext,
  [in]                ULONG Flags,
  [in]                ULONGLONG ErrorRecordId
)
{...}

매개 변수

[in, out, optional] PluginContext

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

[in] Flags

명확한 작업에 영향을 주는 플래그의 비트 단위 OR 조합입니다. 플래그는 현재 정의되어 있지 않습니다.

[in] ErrorRecordId

시스템의 영구 데이터 스토리지에서 지워지는 오류 레코드의 식별자입니다. 이 식별자는 지울 오류 레코드를 식별하기 위해 시스템의 영구 데이터 스토리지에 기록된 각 WHEA_ERROR_RECORD 구조의 Header.RecordId 멤버와 비교되어야 합니다.

반환 값

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

반환 코드	설명
STATUS_SUCCESS	오류 레코드가 시스템의 영구 데이터 스토리지에서 성공적으로 지워졌습니다.
STATUS_UNSUCCESSFUL	오류가 발생했습니다.

설명

오류 레코드 지속성에 참여하는 PSHED 플러그 인은 Callbacks.WriteErrorRecord를 설정합니다. 플러그 인이 PshedRegisterPlugin 함수를 호출하여 PSHED에 등록할 때 Callbacks.ReadErrorRecord 및 Callbacks.ClearErrorRecordWHEA_PSHED_PLUGIN_REGISTRATION_PACKET 구조체의 멤버가 WriteErrorRecord, ReadErrorRecord 및 ClearErrorRecord 콜백 함수를 가리킵니다. 또한 PSHED 플러그 인은 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 구조체의 FunctionalAreaMask 멤버에서 PshedFAErrorRecordPersistence 플래그를 설정해야 합니다.

Windows 커널은 PSHED를 호출하여 시스템의 영구 데이터 스토리지에서 오류 레코드를 지웁니다. PSHED 플러그 인이 오류 레코드 지속성에 참여하도록 등록된 경우 PSHED는 PSHED 플러그 인의 ClearErrorRecord 콜백 함수를 호출하여 명확한 작업을 수행합니다. 시스템의 영구 데이터 스토리지에서 오류 레코드를 지우는 데 사용되는 메커니즘은 플랫폼별로 다릅니다.