macro WIAS_ERROR (wiautil.h)

La macro WIAS_ERROR scrive un messaggio di diagnostica nel file 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 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 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.

Requisiti

   
Client minimo supportato Disponibile in Windows Vista e versioni successive del sistema operativo.
Piattaforma di destinazione Desktop
Intestazione wiautil.h (include Wiautil.h)

Vedi anche

WIAS_ASSERT

WIAS_HRESULT

WIAS_TRACE