IoPropagateActivityIdToThread, fonction (ntddk.h)

Article
02/07/2025

La routine IoPropagateActivityIdToThread associe l’ID d’activité d’un IRP au thread actuel.

Syntaxe

NTSTATUS IoPropagateActivityIdToThread(
  [in]  PIRP    Irp,
  [out] LPGUID  PropagatedId,
        LPCGUID *OriginalId
);

Paramètres

[in] Irp

IRP dont l’ID sera propagé au thread.

[out] PropagatedId

Pointeur vers la mémoire allouée par l’appelant pour stocker l’ID dans le thread.

OriginalId

Lors du retour réussi de l’appel, contient l’ID qui a été précédemment défini sur le thread. Le pilote doit appeler IoClearActivityIdThread avec ce pointeur lorsque le suivi est terminé dans le même contexte de thread.

Valeur de retour

IoPropagateActivityIdToThread retourne STATUS_SUCCESS si l’appel réussit. Les valeurs de retour d’erreur possibles sont les suivantes.

Retourner le code	Description
STATUS_NOT_FOUND	L’IRP n’a pas d’ID associé à celui-ci.

Remarques

Cette routine doit être utilisée par les pilotes qui effectuent le suivi et émettent des E/S sur un thread de travail. Notez que ces pilotes doivent appeler IoClearActivityIdThread avec l'OriginalId avant de retourner le contrôle à partir du thread, si l’appel a réussi.

Les pilotes qui utilisent des éléments de travail d’E/S n’ont pas besoin d’appeler cette routine, car le sous-système d’E/S s’occupe de propager les ID d’activité aux threads dans ce cas.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 8.
plateforme cible	Universel
d’en-tête	ntddk.h (include Ntddk.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	N’importe quel niveau

Partager via