Funzione EtwActivityIdControl (wdm.h)
La funzione EtwActivityIdControl crea, esegue query e imposta l'identificatore di 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 ActivityId passato a questa funzione non deve necessariamente essere uno creato da EVENT_ACTIVITY_CTRL_CREATE_ID o EVENT_ACTIVITY_CTRL_CREATE_SET_ID codice di controllo. È possibile usare qualsiasi valore adatto all'interno di un GUID, incluso qualsiasi valore locale disponibile che servirebbe per un 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 ActivityId e quindi restituisce ActivityId con il valore dell'identificatore dell'attività del thread prima della chiamata alla 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 di attività del thread prima della chiamata alla 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.
Commenti
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 irQL DISPATCH_LEVEL, a meno che 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 i thread kernel degli identificatori di attività.
Requisiti
| 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 |