Función WheaAddErrorSourceDeviceDriver (ntddk.h)

Un controlador de dispositivo llama a WheaAddErrorSourceDeviceDriver para agregar un origen de error.

Sintaxis

NTSTATUS WheaAddErrorSourceDeviceDriver(
  PVOID                                          Context,
  PWHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER Configuration,
  ULONG                                          NumberPreallocatedErrorReports
);

Parámetros

Context

Puntero opcional a un contexto asignado por el autor de la llamada. WHEA proporciona el contexto como parámetro para las rutinas de devolución de llamada proporcionadas por el controlador. Puede ser NULL.

Configuration

Puntero a una estructura de tipo WHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER que contiene un conjunto de rutinas de devolución de llamada proporcionadas por el controlador.

NumberPreallocatedErrorReports

Valor de tipo ULONG que especifica el número de registros que se van a preasignar. Vea Comentarios para obtener más información.

Valor devuelto

Este método de función devuelve STATUS_SUCCESS si se agrega el origen del error. De lo contrario, puede devolver una de las siguientes opciones:

• STATUS_INVALID_PARAMETER: falta la configuración inicializar o anular la inicialización de punteros de devolución de llamada.
• STATUS_INVALID_PARAMETER_2: se envió una configuración con una versión no válida.
• STATUS_INSUFFICIENT_RESOURCES: WHEA no pudo asignar espacio para el origen del error y sus registros.

Comentarios

Para quitar un origen de error, el controlador llama a WheaRemoveErrorSourceDeviceDriver.

WHEA puede asignar previamente memoria para los errores que se notificarán en un IRQL alto (es decir, en el contexto de una interrupción del dispositivo). En el caso de los orígenes de error notificados en PASSIVE_LEVEL, no se requiere la asignación previa, pero si el controlador de dispositivo notifica errores por su origen de error en DISPATCH_LEVEL o superior, los registros de error deben asignarse previamente.

Para obtener más información, consulta Uso de WHEA en Windows 10.

Requisitos

Consulte también

WheaRemoveErrorSourceDeviceDriver

WheaReportHwErrorDeviceDriver

WheaCreateHwErrorReportDeviceDriver