Fonction FltPropagateActivityIdToThread (fltkernel.h)

  • Article

La routine FltPropagateActivityIdToThread associe l’ID d’activité de l’IRP dans les données de rappel du minifiltre au thread actuel.

Syntaxe

NTSTATUS FLTAPI FltPropagateActivityIdToThread(
  [in]     PFLT_CALLBACK_DATA CallbackData,
  [in/out] LPGUID             PropagateId,
  [out]    LPCGUID            *OriginalId
);

Paramètres

[in] CallbackData

Pointeur vers les données de rappel contenant la demande avec un ID d’activité associé.

[in/out] PropagateId

Pointeur vers un GUID alloué à l’appelant qui stocke l’ID d’activité du thread actuel.

[out] OriginalId

Au retour, le pointeur GUID référencé par OriginalId pointe vers l’ID d’activité précédemment défini pour le thread.

Valeur retournée

FltPropagateActivityIdToThread retourne l’une des valeurs NTSTATUS suivantes.

Code de retour Description
STATUS_NOT_SUPPORTED Les données de rappel ne contiennent pas de demande d’opération IRP.
STATUS_NOT_FOUND Aucun ID d’activité n’est associé à la requête dans CallbackData.
STATUS_SUCCESS Un ID d’activité a été retourné dans la valeur GUID pointée par OriginalId.

Remarques

La routine FltPropagateActivityIdToThread est utilisée par les minifiltres prenant en compte les traces. Un minifiltre utilise cette routine pour attacher l’ID d’activité d’un IRP à un thread de travail qui traite les E/S de la requête.

Un minifiltre doit appeler IoClearActivityIdThread avec le pointeur dans OriginalId avant de retourner le contrôle à partir du thread de travail si l’appel à FltPropagateActivityIdToThread a réussi.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 8.
Plateforme cible Universal
En-tête fltkernel.h (inclure Fltkernel.h)
Bibliothèque FltMgr.lib
DLL Fltmgr.sys
IRQL <= DISPATCH_LEVEL

Voir aussi

FltGetActivityIdCallbackData

FltSetActivityIdCallbackData