Método IStiDeviceControl::WriteToErrorLog (stiusd.h)

El método IStiDeviceControl::WriteToErrorLog permite que un minidriver de imagen en modo de usuario escriba un mensaje en el registro de errores de imagen todavía.

Sintaxis

HRESULT WriteToErrorLog(
  DWORD   dwMessageType,
  LPCWSTR pszMessage,
  DWORD   dwErrorCode
);

Parámetros

dwMessageType

Valor constante proporcionado por el autor de la llamada que representa el tipo de mensaje. Los valores siguientes se definen en Sti.h:

STI_TRACE_INFORMATION

STI_TRACE_WARNING

STI_TRACE_ERROR

pszMessage

Puntero proporcionado por el autor de la llamada a una cadena de mensaje que se va a escribir en el archivo de registro.

dwErrorCode

No se usa.

Valor devuelto

Si la operación se realiza correctamente, el método devuelve S_OK. De lo contrario, devuelve uno de los códigos de error con prefijo STIERR definidos en stierr.h.

Observaciones

El archivo de registro de errores de imagen todavía se denomina sti_trace.log y se encuentra en el directorio de Windows. Panel de control permite a un usuario seleccionar qué tipos de error de imagen (informativos, advertencias o errores) se escriben en el registro de errores (consulte Entradas del Registro no modificables).

Los mensajes de error deben reservarse para condiciones de error críticas, como errores de hardware del dispositivo. Los mensajes informativos se pueden usar con fines de depuración propios. Los mensajes registrados no son visibles para los usuarios, pero pueden ser utilizados por un ingeniero de soporte técnico para ayudar a depurar los problemas de un usuario.

Un minidriver de imagen fija recibe un puntero de interfaz IStiDeviceControl como entrada a su método IStiUSD::Initialize .

Requisitos

   
Plataforma de destino Escritorio
Header stiusd.h (incluya Stiusd.h)