PEPCALLBACKPOWERONCRASHDUMPDEVICE callback function (pepfx.h)

Article
10/21/2021

The PowerOnDumpDeviceCallback callback routine turns on the crash-dump device.

Syntax

PEPCALLBACKPOWERONCRASHDUMPDEVICE Pepcallbackpoweroncrashdumpdevice;

BOOLEAN Pepcallbackpoweroncrashdumpdevice(
  [in] PPEP_CRASHDUMP_INFORMATION CrashdumpInformation
)
{...}

Parameters

[in] CrashdumpInformation

A pointer to a PEP_CRASHDUMP_INFORMATION structure that contains information about the crash-dump device.

Return value

This routine returns TRUE if it succeeds in turning on power to the crash-dump device. Otherwise, it returns FALSE.

Remarks

This routine is implemented by the platform extension plug-in (PEP). The routine handles requests from the Windows kernel to turn on the crash-dump device so that a crash dump can be saved to disk.

The PEP registers its PowerOnDumpDeviceCallback routine in response to a PEP_DPM_REGISTER_CRASHDUMP_DEVICE notification from the Windows power management framework (PoFx).

The PowerOnDumpDeviceCallback routine is called at IRQL = HIGH_LEVEL with interrupts disabled. Thus, this routine cannot use timers, events, or any synchronization primitives other than spin locks.

Requirements

Requirement	Value
Minimum supported client	Supported starting with Windows 10.
Target Platform	Windows
Header	pepfx.h (include Pep_x.h)
IRQL	Called at HIGH_LEVEL.