Condividi tramite


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

Vedere anche

EtwWrite

EtwWriteEx

EtwWriteTransfer