Funzione WdfVerifierKeBugCheck (wdfverifier.h)

  • Articolo

[Si applica a KMDF e UMDF]

La funzione WdfVerifierKeBugCheck crea un controllo di 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 .

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 suddivide 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 .For more information about unhandled exceptions in the driver host process, see How UMDF Reports Errors.

Per altre informazioni sul debug del driver, vedere Debug dei driver WDF.

Esempio

Nell'esempio di codice seguente viene creato un controllo di bug che usa il codice di controllo di bug MULTIPLE_IRP_COMPLETE_REQUESTS .

WdfVerifierKeBugCheck(
                      MULTIPLE_IRP_COMPLETE_REQUESTS,
                      (ULONG_PTR) irp,
                      (ULONG_PTR) srb,
                      0,
                      0
                      );

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfverifier.h (include Wdf.h)
Libreria Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Qualsiasi livello
Regole di conformità DDI DriverCreate(kmdf)

Vedi anche

WdfVerifierDbgBreakPoint