macro WIAS_ERROR (wiautil.h)
La macro WIAS_ERROR scrive un messaggio di diagnostica nel file di Wiatrace.log .
Sintassi
void WIAS_ERROR(
x
);
Parametri
x
HInst : gestire la DLL (driver).
Format_string... - Specifica un elenco di argomenti variabile, che inizia con una stringa di formato ANSI che descrive il messaggio e tutti gli identificatori di formato. I puntini di sospensione (...) specifica un numero variabile di argomenti che devono essere restituiti. Il testo dell'errore deve essere preceduto dal nome completo del metodo o della funzione e generare il messaggio nel formato "class::method, error-text".
Valore restituito
nessuno
Osservazioni
Questa macro è il modo consigliato per implementare la registrazione degli errori in Windows Vista, perché a differenza di WIAS_LERROR, WIA_ERROR consente la scrittura dei messaggi di errore nel file di log (Wiatrace.log). Il file Wiatrace.log è disponibile solo in Windows Vista e versioni successive del sistema operativo. L'utilità usata per visualizzare il contenuto di questo file di log è WiaTrcVw.exe.
Per abilitare la traccia nelle compilazioni gratuite, i driver devono definire la macro WIA_DEBUG aggiungendo #define WIA_DEBUG prima di includere una delle intestazioni WIA. La traccia è abilitata per impostazione predefinita nelle build archiviate e di debug del sistema operativo.
Di seguito è riportato un esempio di come può essere usata la macro:
WIAS_ERROR((g_hInst, "Failed to read (%ws) entry under %ws section of device registry",REG_ENTRY_STORAGEPATH,REG_ENTRY_DEVICEDATA));
Questo frammento di codice è stato tratto da Wiadriver.cpp, incluso negli esempi di driver Windows Image Acquisition (WIA) in GitHub.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive del sistema operativo. |
| Piattaforma di destinazione | Desktop |
| Intestazione | wiautil.h (include Wiautil.h) |