Funzione EtwActivityIdControl (wdm.h)
La funzione EtwActivityIdControl crea, esegue query e imposta l'identificatore dell'attività corrente.
Sintassi
NTSTATUS EtwActivityIdControl(
[in] ULONG ControlCode,
[in, out] LPGUID ActivityId
);
Parametri
[in] ControlCode
Il parametro ControlCode può essere uno dei valori definiti seguenti.
| Valore | Significato |
|---|---|
| EVENT_ACTIVITY_CTRL_GET_ID | Restituisce l'identificatore dell'attività del thread corrente nel parametro ActivityId. |
| EVENT_ACTIVITY_CTRL_SET_ID | Imposta l'identificatore dell'attività del thread corrente sul valore specificato in ActivityId. Si noti che il ActivityId passato a questa funzione non deve necessariamente essere creato da EVENT_ACTIVITY_CTRL_CREATE_ID o EVENT_ACTIVITY_CTRL_CREATE_SET_ID codice di controllo. È possibile usare qualsiasi valore che si adatti all'interno di un GUID, incluso qualsiasi valore locale disponibile che soddisfi la necessità di un determinato tipo di identificatore di attività. |
| EVENT_ACTIVITY_CTRL_CREATE_ID | Crea un nuovo identificatore e imposta il parametro ActivityId sul valore del nuovo identificatore. |
| EVENT_ACTIVITY_CTRL_GET_SET_ID | Imposta l'identificatore dell'attività del thread corrente sul valore specificato in ActivityIde quindi restituisce ActivityId con il valore dell'identificatore dell'attività del thread prima della chiamata di funzione. |
| EVENT_ACTIVITY_CTRL_CREATE_SET_ID | Copia l'identificatore dell'attività del thread corrente. Crea un nuovo identificatore e imposta l'identificatore dell'attività del thread corrente sul nuovo valore. Restituisce ActivityId con il valore dell'identificatore dell'attività del thread prima della chiamata di funzione. |
[in, out] ActivityId
Identificatore che indica l'attività associata all'evento. Il parametro ActivityId consente di raggruppare gli eventi correlati e viene usato nella traccia end-to-end.
Valore restituito
EtwActivityIdControl restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato.
Osservazioni
Gli identificatori di attività forniscono un metodo per collegare eventi separati in un thread comune di calcolo. Un'attività è un elemento di lavoro eseguito da un'applicazione e da un driver. Il concetto di attività è un componente principale nella traccia end-to-end.
I chiamanti di EtwActivityIdControl devono essere in esecuzione in < DISPATCH_LEVEL IRQL, a meno che il ControlCode non sia EVENT_ACTIVITY_CTRL_CREATE_ID, nel qual caso la funzione può essere chiamata in qualsiasi IRQL.
Usare la funzione EtwActivityIdControlKernel per eseguire query o impostare gli identificatori di attività sui thread del kernel.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | wdm.h (include Wdm.h, Ntddk.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe; Ntdll.dll |
| IRQL | Vedere la sezione Commenti |