Función WdfVerifierKeBugCheck (wdfverifier.h)

[Se aplica a KMDF y UMDF]

La función WdfVerifierKeBugCheck crea una comprobación de errores.

Sintaxis

void WdfVerifierKeBugCheck(
  [in] ULONG     BugCheckCode,
  [in] ULONG_PTR BugCheckParameter1,
  [in] ULONG_PTR BugCheckParameter2,
  [in] ULONG_PTR BugCheckParameter3,
  [in] ULONG_PTR BugCheckParameter4
);

Parámetros

[in] BugCheckCode

Uno de los códigos de comprobación de errores definidos en Bugcodes.h.

[in] BugCheckParameter1

Para obtener información sobre este parámetro, consulte la descripción del código de comprobación de errores especificado.

[in] BugCheckParameter2

Para obtener información sobre este parámetro, consulte la descripción del código de comprobación de errores especificado.

[in] BugCheckParameter3

Para obtener información sobre este parámetro, consulte la descripción del código de comprobación de errores especificado.

[in] BugCheckParameter4

Para obtener información sobre este parámetro, consulte la descripción del código de comprobación de errores especificado.

Valor devuelto

None

Observaciones

Si el controlador de Kernel-Mode Driver Framework (KMDF) llama a WdfVerifierKeBugCheck, el sistema operativo se detiene y muestra una pantalla azul a menos que se esté ejecutando un depurador .

Si el controlador de User-Mode Driver Framework (UMDF) (versión 2.0 o posterior) llama a WdfVerifierKeBugCheck, el marco no usa los parámetros que proporciona el controlador. En este caso, el marco se divide en el depurador si uno está conectado. Si un depurador no está conectado, el marco genera una excepción y el controlador de excepciones umDF predeterminado crea un archivo de minivolcado. Para obtener más información sobre las excepciones no controladas en el proceso de host del controlador, vea Cómo notifican errores de UMDF.

Para obtener más información sobre cómo depurar el controlador, consulte Depuración de controladores WDF.

Ejemplos

En el ejemplo de código siguiente se crea una comprobación de errores que usa el código de comprobación de errores de MULTIPLE_IRP_COMPLETE_REQUESTS .

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

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Versión mínima de UMDF	2.0
Encabezado	wdfverifier.h (incluya Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	Cualquier nivel
Reglas de cumplimiento de DDI	DriverCreate(kmdf)

Consulte también

WdfVerifierDbgBreakPoint