KBUGCHECK_REASON_CALLBACK_ROUTINE funzione di callback (wdm.h)
Funzioni di callback implementate dal driver eseguite dal sistema quando emette un controllo dei bug.
Per informazioni sui tipi di callback disponibili, vedere KBUGCHECK_CALLBACK_REASON.
Sintassi
KBUGCHECK_REASON_CALLBACK_ROUTINE KbugcheckReasonCallbackRoutine;
void KbugcheckReasonCallbackRoutine(
[in] KBUGCHECK_CALLBACK_REASON Reason,
[in] _KBUGCHECK_REASON_CALLBACK_RECORD *Record,
[in, out] PVOID ReasonSpecificData,
[in] ULONG ReasonSpecificDataLength
)
{...}
Parametri
[in] Reason
Enumerazione di tipo KBUGCHECK_CALLBACK_REASON che specifica il motivo della chiamata alla routine di callback.
[in] Record
Puntatore alla struttura KBUGCHECK_REASON_CALLBACK_RECORD fornita dal driver al momento della registrazione del callback. Per altre informazioni, vedere la descrizione del parametro CallbackRecord in KeRegisterBugCheckReasonCallback.
[in, out] ReasonSpecificData
Puntatore a un buffer contenente una struttura di tipo determinata dalla tabella seguente. Alcuni membri di questa struttura vengono compilati dal sistema operativo prima di chiamare la routine di callback e gli altri membri devono essere compilati dalla routine di callback. Per altre informazioni, vedere Scrittura di una routine di callback di controllo dei bug.
| Valore | Struttura dei dati |
|---|---|
| KbCallbackSecondaryDumpData | KBUGCHECK_SECONDARY_DUMP_DATA |
| KbCallbackDumpIo | KBUGCHECK_DUMP_IO |
| KbCallbackAddPages | KBUGCHECK_ADD_PAGES |
| KbCallbackSecondaryMultiPartDumpData | KBUGCHECK_SECONDARY_DUMP_DATA_EX |
| KbCallbackRemovePages | KBUGCHECK_REMOVE_PAGES |
| KbCallbackTriageDumpData | KBUGCHECK_TRIAGE_DUMP_DATA |
[in] ReasonSpecificDataLength
Specifica le dimensioni, in byte, del buffer a cui punta il parametro ReasonSpecificData.
Valore restituito
Nessuno
Osservazioni
Per informazioni su come implementare questa routine di callback, vedere Scrittura di una routine di callback di controllo dei bug.
Per il codice di esempio che illustra come scrivere dati nel file di dump di arresto anomalo del sistema, vedere DMF_CrashDump.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | Chiamato in HIGH_LEVEL. |
Vedere anche
KBUGCHECK_REASON_CALLBACK_RECORD
KeRegisterBugCheckReasonCallback