macro WIAS_ERROR (wiamdef.h)
La macro WIAS_ERROR scrive un messaggio di diagnostica nel file di Wiatrace.log.
Sintassi
void WIAS_ERROR(
x
);
Parametri
x
HInst : handle per la DLL (driver).
format_string, ... : specifica un elenco di argomenti di variabile, che inizia con una stringa di formato ANSI che descrive il messaggio e gli identificatori di formato. I puntini di sospensione (...) specificano 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, perché a differenza di WIAS_LERROR, WIA_ERROR consente la scrittura dei messaggi di errore nel file di log (Wiatrace.log). 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 qualsiasi intestazione WIA. La traccia è abilitata per impostazione predefinita nelle build archiviate e di debug del sistema operativo.
Di seguito è riportato un esempio di utilizzo della 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | wiamdef.h (include Wiautil.h) |