PoFxPowerOnCrashdumpDevice-Funktion (wdm.h)

Die PoFxPowerOnCrashdumpDevice-Routine fordert an, dass ein Absturzabbildgerät aktiviert wird.

Syntax

NTSTATUS PoFxPowerOnCrashdumpDevice(
  [in]           POHANDLE Handle,
  [in, optional] PVOID    Context
);

Parameter

[in] Handle

Ein Handle, das die Registrierung des Absturzabbildgeräts beim Windows Power Management Framework (PoFx) darstellt. Der Gerätetreiber hat dieses Handle zuvor von der PoFxRegisterDevice-Routine erhalten.

[in, optional] Context

Ein Zeiger auf einen gerätespezifischen Kontext. Dieser Zeiger wird als Eingabeparameter an die Rückrufroutine PowerOnDumpDeviceCallback übergeben, die vom Pep-Plug-In (Platform Extension Plug-In) für das Gerät implementiert wird. Die Kontextinformationen werden in einem Format gespeichert, das vom Gerätetreiber definiert und vom PEP verstanden wird. Dieser Kontext ist für das Betriebssystem nicht transparent. Der Treiber kann diesen Parameter auf NULL festlegen, wenn pep keinen Kontext erfordert.

Rückgabewert

PoFxPowerOnCrashdumpDevice gibt STATUS_SUCCESS zurück, wenn es der Routine gelingt, die Stromversorgung des Geräts zu aktivieren. Mögliche Fehlerrückgabewerte sind die folgenden status Codes.

Rückgabewert	BESCHREIBUNG
STATUS_INVALID_PARAMETER	Kein gültiger Handle-Wert.
STATUS_UNSUCCESSFUL	Das PEP für dieses Gerät implementiert keine PowerOnDumpDeviceCallback-Rückrufroutine . oder der PEP konnte das Gerät nicht einschalten.

Hinweise

Der Treiber für ein Absturzabbildgerät ruft diese Routine auf, um anzufordern, dass das Pep-Plug-In (Platform Extension Plug-In) das Gerät einschalte, damit ein Absturzabbild gespeichert werden kann. Alle Geräte in der Absturzabbild-Gerätekette (die einen Speichercontroller, einen PCI-Controller usw. enthalten kann) müssen aktiviert sein, bevor eine Absturzabbilddatei auf den Datenträger geschrieben werden kann.

Weitere Informationen zu Absturzabbildern finden Sie unter Kernelmodusabbilddateien.

Diese Routine kann unter IRQL <= HIGH_LEVEL aufgerufen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.1.
Zielplattform	Windows
Kopfzeile	wdm.h (pepfx.h einschließen)
Bibliothek	Ntoskrnl.lib
IRQL	<= HIGH_LEVEL

Weitere Informationen

PoFxRegisterDevice

PowerOnDumpDeviceCallback