Fonction FltPropagateActivityIdToThread (fltkernel.h)
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 |