Proprietà del compilatore di messaggi per i progetti driver

  • Articolo

Imposta le proprietà per lo strumento Compilatore di messaggi (MC.exe). Il compilatore genera i file di risorse del messaggio che è possibile aggiungere al progetto.

Ad esempio, se si usa l'API in modalità kernel ETW (Event Tracing for Windows) per aggiungere la traccia di eventi a un driver in modalità kernel, è possibile usare il compilatore di messaggi per creare un file di intestazione contenente definizioni per il provider di eventi, gli attributi degli eventi, i canali e gli eventi. È necessario includere questo file di intestazione nel codice sorgente. Il compilatore di messaggi crea uno script del compilatore di risorse (*.rc) aggiunto al file di progetto.

Impostazione delle proprietà del compilatore di messaggi per i progetti driver

  1. Aprire le pagine delle proprietà per il progetto driver. Selezionare e tenere premuto (o fare clic con il pulsante destro del mouse) sul progetto driver in Esplora soluzioni e scegliere Proprietà.
  2. Nelle pagine delle proprietà per il progetto driver selezionare Proprietà di configurazione e quindi selezionare Compilatore messaggi.
  3. Impostare le proprietà per il progetto.

Questa pagina delle proprietà è disponibile se si aggiunge un file di testo del messaggio (.mc) o un manifesto (con estensione man) alla soluzione.

Opzione Descrizione

Opzioni aggiuntive

Specifica opzioni aggiuntive da passare allo strumento compilatore di messaggi (MC.exe).

Ansi Input File

Specifica che il file di input contiene contenuto ANSI (impostazione predefinita). (-a)

Messaggio Ansi nel file bin

Specifica che i messaggi nell'output .bin file devono essere ANSI. (-A)

Percorso di base

Il percorso deve puntare alla cartella che contiene . File BIN creati dall'operazione di base. (-t directory)

Percorso risorsa di base

Cartella che contiene i file manifesto di base. (-s directory)

Percorso di output di debug

Percorso in cui inserire il file di inclusione con estensione dbg C. (-x path)

Abilita macro callout

Aggiunge una macro callout per richiamare il codice utente durante la registrazione. Non disponibile per C# e ignorato. (-co)

Abilitare il percorso di output di debug

Consente al compilatore di inserire il file di inclusione con estensione dbg C specificato dalla proprietà Debug Output Path .

Estensione di file per l'intestazione generata

Specifica l'estensione del file di intestazione generato. (-e extension)

Genera risorsa baseline

Crea una linea di base della strumentazione.

Generare la classe di registrazione C# (gestita)

Genera una classe di registrazione C# (gestita) che include metodi che si chiamano per registrare gli eventi nel manifesto. (-cs namespace)

Generare il file di intestazione per contenere nomi e GUID dei contatori

Usare questa opzione per specificare la cartella in cui si desidera che il compilatore inserisca il file di intestazione generato.

Generare macro di registrazione in modalità kernel

Genera macro di registrazione in modalità kernel. (-km)

Generare un file MOF

Generare il supporto di livello inferiore per tutte le funzioni e le macro generate. Il file MOF verrà generato dal manifesto. Il file MOF verrà inserito nel percorso specificato dall'opzione -h (-mof).

Genera intestazione OLE2

Genera un file di intestazione OLE2. (-o)

Generare una classe di registrazione C# statica (gestita)

Genera una classe di registrazione C# statica (gestita) che include metodi che si chiamano per registrare gli eventi nel manifesto. (-css namespace)

Generare macro di registrazione in modalità utente

Generare macro di registrazione in modalità utente. (-um)

Nome di base dei file generati

Specifica il nome di base di tutti i file generati. (-z basename)

Percorso dei file di messaggi binari e RC generati

Specifica il percorso dei file di messaggio RC e binari generati.

Percorso del file di intestazione

Specifica il percorso del file di intestazione generato. (-h path)

Lunghezza massima messaggio

Utilizzare questo argomento per fare in modo che il compilatore generi un avviso se un messaggio supera i caratteri di lunghezza. (-m lunghezza)

Nome macro prefisso

Utilizzare questo argomento per eseguire l'override del prefisso predefinito utilizzato dal compilatore per i nomi delle macro di registrazione e dei metodi. (-p prefisso)

Percorso file RC

Cartella in cui si desidera che il compilatore inserisca lo script del compilatore di risorse generato (file RC) e i file .bin generati. (-r path)

Rimuovere caratteri dal nome simbolico

Utilizzare questo argomento per rimuovere i caratteri dall'inizio del nome simbolico specificato per l'evento. (-P prefisso)

Impostare il bit cliente

Imposta il bit Customer nell'intero ID messaggio. (-c)

Termina messaggio con Null

Termina tutte le stringhe con valori Null nelle tabelle dei messaggi. (-n)

Unicode Input File

Specifica che il file di input contiene contenuto Unicode. (-u)

Il valore predefinito è ANSI.

Messaggio Unicode nel file bin

Specifica che i messaggi nell'output .bin file sono Unicode. (-U)

Si tratta dell'impostazione predefinita.

Usare il nome di base dell'input

Utilizzare questo argomento per fare in modo che il compilatore usi il nome di base del file di input per il nome dei file di output .bin. (-b)

Usare i valori decimali

Utilizzare questo argomento per usare i valori decimali per le costanti Gravità e Struttura nel file di intestazione anziché valori esadecimali. (-d)

Convalida su risorsa di base

Usare questo argomento quando si crea una nuova versione del manifesto e si vuole verificarne la compatibilità con la baseline creata usando l'opzione -s .

Verbose

Usare questa opzione per generare un output dettagliato. (-v)