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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10, versión 2004 |
| Encabezado | ntddk.h |