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

Vedi anche

FltGetActivityIdCallbackData

FltSetActivityIdCallbackData