FltPropagateActivityIdToThread, fonction (fltkernel.h)
La routine FltPropagateActivityIdToThread associe l’ID d’activité à partir de l’IRP dans les données de rappel du minifilter avec le 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 requête avec un ID d’activité associé.
[in/out] PropagateId
Pointeur vers un appelant alloué GUID qui stocke l’ID d’activité du thread actuel.
[out] OriginalId
Lors du retour, le GUID pointeur référencé par OriginalId pointe vers l’ID d’activité précédemment défini pour le thread.
Valeur de retour
FltPropagateActivityIdToThread retourne l’une des valeurs de NTSTATUS suivantes.
| Retourner le code | 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 le GUID valeur pointée par OriginalId. |
Remarques
La routine FltPropagateActivityIdToThread est utilisée par les minifilters prenant en compte les traces. Un minifilter utilise cette routine pour attacher l’ID d’activité d’un IRP à un E/S de traitement de thread de travail pour la requête.
Un minifilter 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8. |
| plateforme cible | Universel |
| d’en-tête | fltkernel.h (include Fltkernel.h) |
| bibliothèque | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= DISPATCH_LEVEL |