Funzione WdfVerifierKeBugCheck (wdfverifier.h)

[Si applica a KMDF e UMDF]

La funzione WdfVerifierKeBugCheck crea un controllo dei bug.

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 definiti in Bugcodes.h.

[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)

Vedere anche

WdfVerifierDbgBreakPoint