Funzione FltPropagateActivityIdToThread (fltkernel.h)
La routine FltPropagateActivityIdToThread associa l'ID attività dall'IRP nei dati di callback del minifilter al thread corrente.
Sintassi
NTSTATUS FLTAPI FltPropagateActivityIdToThread(
[in] PFLT_CALLBACK_DATA CallbackData,
[in/out] LPGUID PropagateId,
[out] LPCGUID *OriginalId
);
Parametri
[in] CallbackData
Puntatore ai dati di callback contenenti la richiesta con un ID attività associato.
[in/out] PropagateId
Puntatore a un chiamante allocato GUID che archivia l'ID attività per il thread corrente.
[out] OriginalId
In caso di restituzione, il GUID puntatore a cui fa riferimento OriginalId punta all'ID attività impostato in precedenza per il thread.
Valore restituito
FltPropagateActivityIdToThread restituisce uno dei valori di NTSTATUS seguenti.
| Codice restituito | Descrizione |
|---|---|
| STATUS_NOT_SUPPORTED | I dati di callback non contengono una richiesta per un'operazione IRP. |
| STATUS_NOT_FOUND | Nessun ID attività è associato alla richiesta in CallbackData. |
| STATUS_SUCCESS | Un ID attività è stato restituito nel GUID valore a cui punta OriginalId. |
Osservazioni
La routine FltPropagateActivityIdToThread viene utilizzata dai minifiltri con riconoscimento della traccia. Un minifiltro usa questa routine per associare l'ID attività da un IRP a un I/O di elaborazione thread di lavoro per la richiesta.
Un minifiltro deve chiamare IoClearActivityIdThread con il puntatore in OriginalId prima di restituire il controllo dal thread di lavoro se la chiamata a FltPropagateActivityIdToThread ha avuto esito positivo.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 8. |
| piattaforma di destinazione | Universale |
| intestazione | fltkernel.h (include Fltkernel.h) |
| libreria | FltMgr.lib |
| dll | Fltmgr.sys |
| IRQL | <= DISPATCH_LEVEL |