Funzione IoPropagateActivityIdToThread (ntddk.h)

Articolo
02/29/2024

La routine IoPropagateActivityIdToThread associa l'ID attività da 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.

Commenti

Questa routine deve essere utilizzata dai driver che sono in grado di tenere traccia e eseguono operazioni di I/O in un thread di lavoro. Si noti che tali driver devono chiamare IoClearActivityIdThread con 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.

Requisiti

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

Condividi tramite