macro WIAS_TRACE (wiamdef.h)
La macro WIAS_TRACE scrive un messaggio di diagnostica nel file di Wiatrace.log.
Sintassi
void WIAS_TRACE(
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
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_TRACE((g_hInst,"WIA storage path = %ws",m_wszStoragePath));
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) |