Funzione IoPropagateActivityIdToThread (ntddk.h)

La routine IoPropagateActivityIdToThread associa l'ID attività di un IRP al thread corrente.

Sintassi

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

Parametri

[in] Irp

IRP il cui ID verrà propagato al thread.

[out] PropagatedId

Puntatore alla memoria allocata dal chiamante per archiviare l'ID nel thread.

OriginalId

Al termine della restituzione dalla chiamata, contiene l'ID impostato in precedenza nel thread. Il driver deve chiamare IoClearActivityIdThread con questo puntatore quando la traccia viene completata nello stesso contesto del thread.

Valore restituito

IoPropagateActivityIdToThread restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I valori restituiti di errore possibili includono quanto segue.

Codice restituito	Descrizione
STATUS_NOT_FOUND	L'IRP non dispone di un ID associato.

Osservazioni

Questa routine deve essere usata dai driver che sono in grado di tenere traccia e che eseguono operazioni di I/O in un thread di lavoro. Si noti che tali driver devono chiamare IoClearActivityIdThread con il OriginalId prima di restituire il controllo dal thread, se la chiamata ha avuto esito positivo.

I driver che usano elementi di lavoro di I/O non devono chiamare questa routine perché il sottosistema di I/O si occupa della propagazione degli ID attività ai thread in questo caso.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 8.
piattaforma di destinazione	Universale
intestazione	ntddk.h (include Ntddk.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	Qualsiasi livello