Funzione EtwWriteString (wdm.h)

Articolo
02/29/2024

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).

Vedi anche

EtwWrite

EtwWriteEx

EtwWriteTransfer

Condividi tramite