PEPCALLBACKPOWERONCRASHDUMPDEVICE callback function (pep_x.h)

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 pep_x.h (include Pep_x.h)
IRQL Called at HIGH_LEVEL.

See also

PEP_CRASHDUMP_INFORMATION

PEP_DPM_REGISTER_CRASHDUMP_DEVICE