Funzione WdfVerifierKeBugCheck (wdfverifier.h)
[Si applica a KMDF e UMDF]
La funzione WdfVerifierKeBugCheck
Sintassi
void WdfVerifierKeBugCheck(
[in] ULONG BugCheckCode,
[in] ULONG_PTR BugCheckParameter1,
[in] ULONG_PTR BugCheckParameter2,
[in] ULONG_PTR BugCheckParameter3,
[in] ULONG_PTR BugCheckParameter4
);
Parametri
[in] BugCheckCode
Uno dei codici di controllo dei bug
[in] BugCheckParameter1
Per informazioni su questo parametro, vedere la descrizione del codice di controllo dei bug specificato.
[in] BugCheckParameter2
Per informazioni su questo parametro, vedere la descrizione del codice di controllo dei bug specificato.
[in] BugCheckParameter3
Per informazioni su questo parametro, vedere la descrizione del codice di controllo dei bug specificato.
[in] BugCheckParameter4
Per informazioni su questo parametro, vedere la descrizione del codice di controllo dei bug specificato.
Valore restituito
Nessuno
Osservazioni
Se il driver Kernel-Mode Driver Framework (KMDF) chiama WdfVerifierKeBugCheck, il sistema operativo si interrompe e visualizza una schermata blu a meno che non sia in esecuzione un debugger. Per altre informazioni, vedere Introduzione a WinDbg - Modalità kernel.
Se il driver User-Mode Driver Framework (UMDF) (versione 2.0 o successiva) chiama WdfVerifierKeBugCheck, il framework non usa i parametri forniti dal driver. In questo caso, il framework si interrompe nel debugger se ne è connesso uno. Se un debugger non è connesso, il framework genera un'eccezione e il gestore di eccezioni UMDF predefinito crea un file minidump. Per altre informazioni sulle eccezioni non gestite nel processo host del driver, vedere How UMDF Reports Errors.
Per altre informazioni sul debug del driver, vedere Debug dei driver WDF.
Esempi
Nell'esempio di codice seguente viene creato un controllo di bug che usa il codice di controllo dei bug MULTIPLE_IRP_COMPLETE_REQUESTS.
WdfVerifierKeBugCheck(
MULTIPLE_IRP_COMPLETE_REQUESTS,
(ULONG_PTR) irp,
(ULONG_PTR) srb,
0,
0
);
Fabbisogno
Requisito | Valore |
---|---|
piattaforma di destinazione | Universale |
versione minima di KMDF | 1.0 |
versione minima di UMDF | 2.0 |
intestazione |
wdfverifier.h (include Wdf.h) |
libreria |
Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL | Qualsiasi livello |
regole di conformità DDI | DriverCreate(kmdf) |