Condividi tramite

Scrittura nel registro eventi di sistema

  • Articolo

Gli errori vengono specificati dal relativo valore NTSTATUS. Il sistema definisce valori NTSTATUS specifici che possono essere usati dai driver e i writer di driver possono definire errori aggiuntivi. Si noti che è possibile usare solo determinati valori NTSTATUS durante la registrazione degli errori.

Ogni valore NTSTATUS che può essere utilizzato durante la registrazione degli errori ha un messaggio di errore associato. Ad esempio, il driver di porta parallela usa il valore NTSTATUS PAR_INTERRUPT_CONFLICT per rappresentare conflitti di interruzione hardware, con il testo del messaggio "Conflitto di interrupt rilevato per %1".

Il Visualizzatore eventi visualizza il testo del messaggio nella casella di testo Descrizione della finestra delle proprietà della voce di log. Se la stringa di testo del messaggio contiene "%1", il Visualizzatore eventi lo sostituisce con il nome del dispositivo che ha registrato la voce. Il testo del messaggio può contenere parametri aggiuntivi nel formato "%2", "%3" e così via. Quando il driver registra l'errore, può fornire valori stringa per tali parametri. Questi valori stringa sono noti come stringhe di inserimento. Il Visualizzatore eventi li inserisce automaticamente al posto dei valori di percentuale.

Il driver può anche includere dati binari nella voce di log, noti come dati di dump. Nella Visualizzatore eventi vengono visualizzati i dati di dump nella casella di testo Dati della finestra delle proprietà della voce di log.

È possibile visualizzare la finestra delle proprietà per una voce di log facendo doppio clic sulla voce nella Visualizzatore eventi. La schermata seguente mostra una finestra delle proprietà della voce di log di esempio.

screenshot di una finestra delle proprietà dell'evento.

I driver usano la routine IoAllocateErrorLogEntry per allocare una voce del log degli errori. Le voci di log sono costituite da un'intestazione di IO_ERROR_LOG_PACKET a lunghezza variabile, seguita da stringhe di inserimento.

Il diagramma seguente illustra il layout di una voce del log degli errori in memoria.

Diagramma che illustra un layout di un pacchetto del log degli errori in memoria .

Il membro ErrorCode di IO_ERROR_LOG_PACKET specifica il valore NTSTATUS dell'errore. Il membro DumpData specifica i dati di dump per la voce di log. DumpData è una matrice di dimensioni variabili, le cui dimensioni sono specificate dal membro DumpDataSize . I driver specificano l'inizio della prima stringa di inserimento con il membro StringOffset e il numero di stringhe nel membro NumberOfStrings . Ogni stringa di inserimento è una stringa Unicode con terminazione Null.

Dopo aver compilato la voce del log degli errori allocata, il driver scrive la voce nel log degli errori usando IoWriteErrorLogEntry. IoWriteErrorLogEntry libera automaticamente la memoria allocata per la voce di log. I driver possono usare IoFreeErrorLogEntry per liberare tutte le voci di log inutilizzate.

I codici di errore predefiniti (del modulo IO_ERR_XXX) sono definiti nel file di intestazione ntiologc.h incluso in Windows Driver Kit (WDK). Il messaggio di errore associato a ogni codice di errore è reperibile nei commenti per ntiologc.h, accanto alla dichiarazione del codice di errore. Per usare un codice di errore predefinito, il driver deve registrare il file di sistema, iologmsg.dll, come origine dei messaggi di errore associati. Per altre informazioni, vedere Registrazione come origine dei messaggi di errore.

I driver possono anche definire i propri tipi di errore personalizzati e i messaggi di errore associati. Per altre informazioni, vedere Definizione di tipi di errore personalizzati.