Funzione IoPropagateActivityIdToThread (ntddk.h)

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.

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