Função FltPropagateActivityIdToThread (fltkernel.h)
A rotina FltPropagateActivityIdToThread associa a ID da atividade do IRP nos dados de retorno de chamada do minifiltro ao thread atual.
Sintaxe
NTSTATUS FLTAPI FltPropagateActivityIdToThread(
[in] PFLT_CALLBACK_DATA CallbackData,
[in/out] LPGUID PropagateId,
[out] LPCGUID *OriginalId
);
Parâmetros
[in] CallbackData
Ponteiro para os dados de retorno de chamada que contêm a solicitação com uma ID de atividade associada.
[in/out] PropagateId
Ponteiro para um chamador alocado GUID que armazena a ID da atividade para o thread atual.
[out] OriginalId
No retorno, o ponteiro guid referenciado por OriginalId aponta para a ID da atividade que foi definida anteriormente para o thread.
Valor de retorno
FltPropagateActivityIdToThread retorna um dos seguintes valores de NTSTATUS.
| Código de retorno | Descrição |
|---|---|
| STATUS_NOT_SUPPORTED | Os dados de retorno de chamada não contêm uma solicitação para uma operação IRP. |
| STATUS_NOT_FOUND | Nenhuma ID de atividade está associada à solicitação em CallbackData. |
| STATUS_SUCCESS | Uma ID de atividade foi retornada no valor de guid do apontado por originalId. |
Observações
A rotina FltPropagateActivityIdToThread é usada por minifiltros com reconhecimento de rastreamento. Um minifiltro usa essa rotina para anexar a ID de atividade de um IRP a uma E/S de processamento de thread de trabalho para a solicitação.
Um minifiltro deve chamar IoClearActivityIdThread com o ponteiro em OriginalId antes de retornar o controle do thread de trabalho se a chamada para FltPropagateActivityIdToThread tiver sido bem-sucedida.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 8. |
| da Plataforma de Destino | Universal |
| cabeçalho | fltkernel.h (inclua Fltkernel.h) |
| biblioteca | FltMgr.lib |
| de DLL | Fltmgr.sys |
| IRQL | <= DISPATCH_LEVEL |