Funzione PoFxRegisterCrashdumpDevice (wdm.h)

La routine PoFxRegisterCrashdumpDevice registra un dispositivo di dump anomalo.

Sintassi

NTSTATUS PoFxRegisterCrashdumpDevice(
  POHANDLE Handle
);

Parametri

Handle

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

Valore restituito

PoFxRegisterCrashdumpDevice restituisce STATUS_SUCCESS se la routine registra correttamente il dispositivo di dump anomalo. I valori restituiti degli errori possibili includono i codici di stato seguenti.

Commenti

Questa routine viene chiamata dal driver per un dispositivo di dump di arresto anomalo per informare PoFx che il dispositivo fa parte della catena di dispositivi di dump di arresto anomalo. Diversi dispositivi (controller di archiviazione, controller PCI e così via) potrebbero essere attivati in modo che il kernel di Windows possa scrivere un file di dump di arresto anomalo su disco. Quando si verifica un errore di sistema irreversibile, il kernel tenta di attivare i dispositivi di dump di arresto anomalo e salvare il file di dump anomalo.

Il driver deve chiamare PoFxRegisterDevice per registrare il dispositivo con PoFx prima di chiamare PoFxRegisterCrashdumpDevice.

Il driver per un dispositivo di dump anomalo può chiamare la routine PoFxPowerOnCrashdumpDevice per richiedere che il PEP attiva il dispositivo.

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

PoFxRegisterCrashdumpDevice deve essere chiamato in IRQL = PASSIVE_LEVEL.

Requisiti

Vedi anche

PoFxPowerOnCrashdumpDevice

PoFxRegisterDevice