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