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, 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. Puoi definire le parole chiave e le posizioni di bit oppure puoi usare parole chiave standard di Windows oppure puoi usare la combinazione di parole chiave personalizzate e parole chiave di Windows.
[in, optional] ActivityId
Identificatore che indica l'attività associata all'evento. Il 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.
Osservazioni
Poiché la stringa prodotta da EventWriteString funzione 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, tutti i dati passati al EtwWrite, EtwWriteEx, EtwWriteStringe funzioni EtwWriteTransfer non devono essere pageable. Ovvero, qualsiasi routine in modalità kernel in esecuzione in IRQL maggiore di APC_LEVEL non può accedere alla memoria paging. I dati passati al EtwWrite, EtwWriteEx, EtwWriteStringe funzioni EtwWriteTransfer devono risiedere nella memoria dello spazio di sistema, indipendentemente da ciò che è IRQL.
Fabbisogno
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). |