Funzione EtwWriteString (wdm.h)
La funzione EventWriteString è una funzione di traccia che è possibile usare quando non sono necessari dati sofisticati. Questa funzione è simile a un'istruzione di stampa di debug.
Sintassi
NTSTATUS EtwWriteString(
[in] REGHANDLE RegHandle,
[in] UCHAR Level,
[in] ULONGLONG Keyword,
[in, optional] LPCGUID ActivityId,
[in] PCWSTR String
);
Parametri
[in] RegHandle
Puntatore all'handle di registrazione del provider di eventi, che viene restituito dalla funzione EtwRegister se la registrazione del provider di eventi ha esito positivo.
[in] Level
Livello in cui l'evento è attivo.
[in] Keyword
Parola chiave per l'evento. Una parola chiave è una maschera di bit che esegue istruzioni generali sulla categoria dell'evento o dell'errore. Poiché la parola chiave è una maschera di bit, è possibile applicare più parole chiave a un singolo evento. È possibile definire le parole chiave e le posizioni di bit oppure usare parole chiave standard di Windows oppure è possibile usare la combinazione di parole chiave personalizzate e parole chiave di Windows.
[in, optional] ActivityId
Identificatore che indica l'attività associata all'evento. ActivityId consente di raggruppare gli eventi correlati e viene usato nella traccia end-to-end. Questo identificatore è facoltativo e può essere NULL.
[in] String
Stringa con terminazione Null (WCHAR).
Valore restituito
La funzione restituisce STATUS_SUCCESS se l'evento viene pubblicato correttamente.
Commenti
Poiché la stringa prodotta dalla funzione EventWriteString non è localizzabile, questa funzione non è consigliata per l'uso nel codice di produzione. Questa funzione non deve essere usata per registrare eventi altamente visibili.
È possibile chiamare EtwWriteString in qualsiasi IRQL. Tuttavia, quando IRQL è maggiore di APC_LEVEL, i dati passati alle funzioni EtwWrite, EtwWriteEx, EtwWriteString e EtwWriteTransfer non devono essere visualizzabili. Ovvero, qualsiasi routine in modalità kernel in esecuzione in IRQL maggiore di APC_LEVEL non può accedere alla memoria di paging. I dati passati alle funzioni EtwWrite, EtwWriteEx, EtwWriteString e EtwWriteTransfer devono risiedere nella memoria dello spazio di sistema, indipendentemente dal valore di IRQL.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile in Windows Vista e versioni successive di Windows. |
Piattaforma di destinazione | Universale |
Intestazione | wdm.h (include Wdm.h, Ntddk.h) |
Libreria | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | Qualsiasi livello (vedere la sezione Commenti). |