Función VideoPortLogError (video.h)

El VideoPortLogError función 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 uno está asociado al error; de lo 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 la misma ErrorCode. Para algunos controladores de miniporte, esto identifica la línea de código donde se detectó el error; para otros, es un valor devuelto por el hardware.

Valor devuelto

Ninguno

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 producir un error 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 miniport deben no errores de registro, como "no se pudo detectar hardware", que se producen con frecuencia durante el funcionamiento normal.

videoPortLogError se puede llamar desde una función de HwVidInterrupt o HwVidSynchronizeExecutionCallback.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000
de la plataforma de destino de	Escritorio
encabezado de	video.h (incluya Video.h)
biblioteca de	Videoprt.lib
DLL de	Videoprt.sys
irQL	<= DIRQL

Consulte también

VideoDebugPrint