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 |
|---|---|
|
Kein gültiger Handle-Wert. |
|
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 |