macro WIAS_ASSERT (wiamdef.h)

La macro WIAS_ASSERT scrive un messaggio di diagnostica nel file di Wiatrace.log .

Sintassi

void WIAS_ASSERT(
   x,
   y
);

Parametri

x

Specifica qualsiasi espressione logica.

y

Handle per la DLL (driver).

Valore restituito

nessuno

Osservazioni

La macro WIAS_ASSERT viene usata per eseguire il debug dei driver WIA. Viene usato per verificare che venga soddisfatta una determinata condizione. Se il parametro Expression restituisce TRUE, questa macro non esegue alcuna operazione. Se Expression restituisce FALSE, la macro stampa una stringa di errore nel file di log di diagnostica Wiatrace.log . Questo messaggio di errore conterrà il nome e il percorso del driver chiamante e il numero di riga nel codice sorgente del driver in cui la macro WIAS_ASSERT non è riuscita.

La macro WIAS_ASSERT è disponibile in Windows Vista e versioni successive del sistema operativo. Questa macro è il modo consigliato per implementare asserzioni WIA in Windows Vista. WIAS_ASSERT consente di scrivere 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 le asserzioni nelle compilazioni gratuite, i driver devono definire la macro WIA_DEBUG aggiungendo #define WIA_DEBUG al codice sorgente del driver. Questa operazione deve essere eseguita prima di includere le intestazioni WIA. Le asserzioni sono abilitate per impostazione predefinita nelle build archiviate e di debug del sistema operativo.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione wiamdef.h (include Wiautil.h)

Vedi anche

WIAS_ERROR

WIAS_HRESULT

WIAS_TRACE