macro WIAS_ERROR (wiautil.h)
La macro WIAS_ERROR escribe un mensaje de diagnóstico en el archivo Wiatrace.log .
Sintaxis
void WIAS_ERROR(
x
);
Parámetros
x
HInst : identificador del archivo DLL (controlador).
format_string, ... : especifica una lista de argumentos de variable, que comienza con una cadena de formato ANSI que describe el mensaje y los identificadores de formato. Los puntos suspensivos (...) especifican un número variable de argumentos que deben generarse. El texto de error debe tener el prefijo con el nombre completo del método o la función y generar el mensaje con el formato "class::method, error-text".
Valor devuelto
None
Observaciones
Esta macro es la manera recomendada de implementar el registro de errores en Windows Vista, ya que, a diferencia de WIAS_LERROR, WIA_ERROR permite escribir mensajes de error en el archivo de registro (Wiatrace.log). El archivo Wiatrace.log solo está disponible en Windows Vista y versiones posteriores del sistema operativo. La utilidad utilizada para ver el contenido de este archivo de registro es WiaTrcVw.exe.
Para habilitar el seguimiento en compilaciones gratuitas, los controladores deben definir la macro WIA_DEBUG agregando #define WIA_DEBUG antes de incluir cualquiera de los encabezados WIA. El seguimiento está habilitado de forma predeterminada en compilaciones activadas y de depuración del sistema operativo.
A continuación se muestra un ejemplo de cómo se puede usar la macro:
WIAS_ERROR((g_hInst, "Failed to read (%ws) entry under %ws section of device registry",REG_ENTRY_STORAGEPATH,REG_ENTRY_DEVICEDATA));
Este fragmento de código se tomó de Wiadriver.cpp, que se incluye con los ejemplos de controladores de adquisición de imágenes de Windows (WIA) en GitHub.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores del sistema operativo. |
| Plataforma de destino | Escritorio |
| Encabezado | wiautil.h (incluye Wiautil.h) |