Función EngBugCheckEx (winddi.h)

Artículo
03/15/2023

La función EngBugCheckEx reduce el sistema de forma controlada cuando el autor de la llamada detecta un error irrecuperable que dañaría el sistema si el autor de la llamada seguía ejecutándose.

Sintaxis

ENGAPI VOID EngBugCheckEx(
  [in] ULONG     BugCheckCode,
  [in] ULONG_PTR P1,
  [in] ULONG_PTR P2,
  [in] ULONG_PTR P3,
  [in] ULONG_PTR P4
);

Parámetros

[in] BugCheckCode

Especifica un valor que indica el motivo de la comprobación de errores.

[in] P1

Puntero a un valor que proporciona información adicional, como la dirección y los datos en los que se produjo un error de daños en la memoria. El valor depende del valor del parámetro BugCheckCode .

[in] P2

[in] P3

[in] P4

Valor devuelto

None

Observaciones

Una comprobación de errores es un error detectado por el sistema que provoca un apagado inmediato y controlado del sistema. Cuando un controlador de gráficos detecta un error irrecuperable, debe generar una comprobación de errores.

Un controlador de gráficos debe llamar a EngBugCheckEx solo en caso de un error irrecuperable irrecuperable que podría dañar el sistema. Siempre que sea posible, todos los controladores de gráficos deben registrar un error y seguir ejecutándose. Por ejemplo, si un controlador no puede asignar los recursos necesarios, debe registrar un error para que el sistema continúe ejecutándose; no debe generar una comprobación de errores.

EngBugCheckEx puede ser útil en las primeras fases del desarrollo de un controlador de gráficos o mientras se está realizando pruebas. En estas circunstancias, el valor bugCheckCode que se pasa a esta función debe ser distinto de los códigos que Ya están en uso por Windows o sus controladores. Para obtener una lista de estos códigos, consulte Códigos de comprobación de errores.

Sin embargo, incluso durante el desarrollo del controlador, esta rutina es de solo uso limitado, ya que da como resultado un apagado completo del sistema. Un método de depuración más eficaz consiste en adjuntar un depurador de kernel al sistema y, a continuación, usar rutinas que envían mensajes al depurador o se dividen en el depurador. Para obtener más información, vea Usar código de depuración en un controlador.

Requisitos

Requisito	Value
Cliente mínimo compatible	Esta función está disponible en Microsoft Windows Server 2003 y versiones posteriores.
Plataforma de destino	Universal
Encabezado	winddi.h (incluya Winddi.h)
Library	Win32k.lib
Archivo DLL	Win32k.sys

Compartir a través de