PoFxRegisterCrashdumpDevice-Funktion (wdm.h)

Die PoFxRegisterCrashdumpDevice-Routine registriert ein Absturzabbildgerät.

Syntax

NTSTATUS PoFxRegisterCrashdumpDevice(
  POHANDLE Handle
);

Parameter

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.

Rückgabewert

PoFxRegisterCrashdumpDevice gibt STATUS_SUCCESS zurück, wenn die Routine das Absturzabbildgerät erfolgreich registriert. Mögliche Fehlerrückgabewerte umfassen die folgenden status-Codes.

Rückgabewert	BESCHREIBUNG
STATUS_INVALID_PARAMETER	Kein gültiger Handle-Wert.
STATUS_UNSUCCESSFUL	Es gibt kein PEP für dieses Gerät.

Hinweise

Diese Routine wird vom Treiber für ein Absturzabbildgerät aufgerufen, um PoFx darüber zu informieren, dass das Gerät Teil der Absturzabbild-Gerätekette ist. Möglicherweise müssen mehrere Geräte (Speichercontroller, PCI-Controller usw.) aktiviert werden, damit der Windows-Kernel eine Absturzabbilddatei auf den Datenträger schreiben kann. Wenn ein schwerwiegender Systemfehler auftritt, versucht der Kernel, die Absturzabbildgeräte zu aktivieren und die Absturzabbilddatei zu speichern.

Der Treiber muss PoFxRegisterDevice aufrufen, um das Gerät bei PoFx zu registrieren, bevor PoFxRegisterCrashdumpDevice aufgerufen wird.

Der Treiber für ein Absturzabbildgerät kann die PoFxPowerOnCrashdumpDevice-Routine aufrufen, um anzufordern, dass pep das Gerät einschaltet.

Weitere Informationen zu Absturzabbildern finden Sie unter Kernelmodusdumpdateien.

PoFxRegisterCrashdumpDevice muss unter IRQL = PASSIVE_LEVEL aufgerufen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.1.
Zielplattform	Windows
Kopfzeile	wdm.h (include Pepfx.h)
Bibliothek	Ntoskrnl.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

PoFxPowerOnCrashdumpDevice

PoFxRegisterDevice