Función VideoPortLogError (video.h)
La función VideoPortLogError registra errores en el registro de eventos del sistema cuando un controlador de miniporta detecta una condición de error de hardware durante las operaciones de E/S.
Sintaxis
VIDEOPORT_API VOID VideoPortLogError(
PVOID HwDeviceExtension,
PVIDEO_REQUEST_PACKET Vrp,
VP_STATUS ErrorCode,
ULONG UniqueId
);
Parámetros
HwDeviceExtension
Puntero a la extensión del dispositivo del controlador de minipuerto.
Vrp
[opcional] Puntero a una estructura [VIDEO_REQUEST_PACKET] que describe el paquete de solicitud de vídeo (VRP) si está asociado al error; en caso contrario, NULL.
ErrorCode
Especifica un código de error definido por el controlador de miniporte que indica el tipo de error de hardware.
UniqueId
Especifica un identificador único para el error. Este valor diferencia el error actual de otros errores con el mismo ErrorCode. Para algunos controladores de minipuerto, esto identifica la línea de código donde se detectó el error; para otros, es un valor devuelto por el hardware.
Valor devuelto
None
Observaciones
Los controladores de Miniport deben llamar a VideoPortLogError para notificar al usuario si el controlador encuentra errores de hardware inusuales durante las operaciones normales. Al publicar estos errores en el registro de eventos del sistema se advierte al usuario de que el adaptador de vídeo podría estar fallando para que el usuario pueda reemplazar (o volver a configurar) el adaptador antes de que se produzca un error total de hardware.
Sin embargo, los controladores de minipuerto no deben registrar errores, como "no se pudo detectar hardware", que se producen con frecuencia durante el funcionamiento normal.
Se puede llamar a VideoPortLogError desde una función HwVidInterrupt o HwVidSynchronizeExecutionCallback del controlador de miniporte.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 |
| Plataforma de destino | Escritorio |
| Encabezado | video.h (incluir Video.h) |
| Library | Videoprt.lib |
| Archivo DLL | Videoprt.sys |
| IRQL | <= DIRQL |