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

Consulte también

VideoDebugPrint