Funzione FltPropagateActivityIdToThread (fltkernel.h)
La routine FltPropagateActivityIdToThread associa l'ID attività dall'IRP nei dati di callback del minifilter con il 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 GUID allocato del chiamante che archivia l'ID attività per il thread corrente.
[out] OriginalId
Al ritorno, il puntatore GUID a cui fa riferimento OriginalId punta all'ID attività impostato in precedenza per il thread.
Valore restituito
FltPropagateActivityIdToThread restituisce uno dei valori 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 valore GUID a cui fa riferimento OriginalId. |
Commenti
La routine FltPropagateActivityIdToThread viene usata da minifilter con riconoscimento della traccia. Un minifilter usa questa routine per collegare l'ID attività da un'IRP a un thread di lavoro per l'I/O per la richiesta.
Un minifilter 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 8. |
| Piattaforma di destinazione | Universale |
| Intestazione | fltkernel.h (includere Fltkernel.h) |
| Libreria | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= DISPATCH_LEVEL |