Función FltPropagateActivityIdToThread (fltkernel.h)
La rutina FltPropagateActivityIdToThread asocia el identificador de actividad del IRP en los datos de devolución de llamada del minifiltro con el subproceso actual.
Sintaxis
NTSTATUS FLTAPI FltPropagateActivityIdToThread(
[in] PFLT_CALLBACK_DATA CallbackData,
[in/out] LPGUID PropagateId,
[out] LPCGUID *OriginalId
);
Parámetros
[in] CallbackData
Puntero a los datos de devolución de llamada que contienen la solicitud con un identificador de actividad asociado.
[in/out] PropagateId
Puntero a un GUID asignado por el autor de la llamada que almacena el identificador de actividad del subproceso actual.
[out] OriginalId
Al devolver, el puntero GUID al que hace referencia OriginalId apunta al identificador de actividad que se estableció anteriormente para el subproceso.
Valor devuelto
FltPropagateActivityIdToThread devuelve uno de los siguientes valores NTSTATUS .
| Código devuelto | Descripción |
|---|---|
| STATUS_NOT_SUPPORTED | Los datos de devolución de llamada no contienen una solicitud para una operación IRP. |
| STATUS_NOT_FOUND | No hay ningún identificador de actividad asociado a la solicitud en CallbackData. |
| STATUS_SUCCESS | Se devolvió un identificador de actividad en el valor GUID al que apunta OriginalId. |
Comentarios
La rutina FltPropagateActivityIdToThread se usa mediante minifiltros compatibles con seguimiento. Un minifiltro usa esta rutina para adjuntar el identificador de actividad de un IRP a una E/S de procesamiento de subprocesos de trabajo para la solicitud.
Un minifiltro debe llamar a IoClearActivityIdThread con el puntero en OriginalId antes de devolver el control del subproceso de trabajo si la llamada a FltPropagateActivityIdToThread se realizó correctamente.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 8. |
| Plataforma de destino | Universal |
| Encabezado | fltkernel.h (incluya Fltkernel.h) |
| Library | FltMgr.lib |
| Archivo DLL | Fltmgr.sys |
| IRQL | <= DISPATCH_LEVEL |