WIAS_ERROR macro (wiautil.h)
A macro WIAS_ERROR grava uma mensagem de diagnóstico no arquivo de Wiatrace.log .
Sintaxe
void WIAS_ERROR(
x
);
Parâmetros
x
HInst - Identificador para a DLL (driver).
Format_string... – Especifica uma lista de argumentos variáveis, que começa com uma cadeia de caracteres de formato ANSI que descreve a mensagem e todos os identificadores de formato. As reticências (...) especificam um número variável de argumentos que precisam ser gerados. O texto de erro deve ser prefixado com o nome completo do método ou função e gerar a mensagem no formato "class::method, error-text".
Retornar valor
Nenhum
Comentários
Essa macro é a maneira recomendada de implementar o log de erros no Windows Vista, pois ao contrário de WIAS_LERROR, WIA_ERROR permite que mensagens de erro sejam gravadas no arquivo de log (Wiatrace.log). O arquivo Wiatrace.log só está disponível no Windows Vista e em versões posteriores do sistema operacional. O utilitário usado para exibir o conteúdo desse arquivo de log é WiaTrcVw.exe.
Para habilitar o rastreamento em builds gratuitos, os drivers devem definir a macro WIA_DEBUG adicionando #define WIA_DEBUG antes de incluir qualquer um dos cabeçalhos WIA. O rastreamento é habilitado por padrão em builds verificados e depurados do sistema operacional.
Veja a seguir um exemplo de como a macro pode ser usada:
WIAS_ERROR((g_hInst, "Failed to read (%ws) entry under %ws section of device registry",REG_ENTRY_STORAGEPATH,REG_ENTRY_DEVICEDATA));
Este snippet de código foi obtido de Wiadriver.cpp, que está incluído com os exemplos de driver wia (aquisição de imagens do Windows) no GitHub.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores do sistema operacional. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wiautil.h (inclua Wiautil.h) |