Funzione PoFxPowerOnCrashdumpDevice (wdm.h)

Articolo
03/05/2024

La routine PoFxPowerOnCrashdumpDevice richiede l'attivazione di un dispositivo di dump di arresto anomalo del sistema.

Sintassi

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

Parametri

[in] Handle

Handle che rappresenta la registrazione del dispositivo di dump di arresto anomalo del sistema con il framework di risparmio energia di Windows (PoFx). Il driver di dispositivo ha ricevuto in precedenza questo handle dalla routine PoFxRegisterDevice .

[in, optional] Context

Puntatore a un contesto specifico del dispositivo. Questo puntatore viene passato come parametro di input alla routine di callback PowerOnDumpDeviceCallback implementata dal plug-in di estensione della piattaforma (PEP) per il dispositivo. Le informazioni sul contesto vengono archiviate in un formato definito dal driver di dispositivo e compreso dal PEP. Questo contesto è opaco al sistema operativo. Il driver può impostare questo parametro su NULL se il PEP non richiede un contesto.

Valore restituito

PoFxPowerOnCrashdumpDevice restituisce STATUS_SUCCESS se la routine riesce ad accendere l'alimentazione del dispositivo. I valori restituiti di errore possibili includono i codici di stato seguenti.

Valore restituito	Descrizione
STATUS_INVALID_PARAMETER	Valore handle non valido.
STATUS_UNSUCCESSFUL	Il PEP per questo dispositivo non implementa una routine di callback PowerOnDumpDeviceCallback ; o pep non è riuscito ad accendere il dispositivo.

Commenti

Il driver per un dispositivo di dump di arresto anomalo del sistema chiama questa routine per richiedere che il plug-in dell'estensione della piattaforma (PEP) accesa il dispositivo in modo che possa essere salvato un dump di arresto anomalo del sistema. Tutti i dispositivi nella catena di dispositivi di dump di arresto anomalo del sistema (che possono includere un controller di archiviazione, un controller PCI e così via) devono essere attivati prima che un file di dump di arresto anomalo del sistema possa essere scritto su disco.

Per altre informazioni sui dump di arresto anomalo del sistema, vedere File di dump in modalità kernel.

Questa routine può essere chiamata in IRQL <= HIGH_LEVEL.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8.1.
Piattaforma di destinazione	Windows
Intestazione	wdm.h (include Pepfx.h)
Libreria	Ntoskrnl.lib
IRQL	<= HIGH_LEVEL

Vedi anche

PoFxRegisterDevice

PowerOnDumpDeviceCallback

Condividi tramite