Condividi tramite


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 : 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, 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 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
Piattaforma di destinazione Desktop
Intestazione wiamdef.h (include Wiautil.h)

Vedi anche

WIAS_ASSERT

WIAS_HRESULT

WIAS_TRACE