Função FltPropagateActivityIdToThread (fltkernel.h)

A rotina FltPropagateActivityIdToThread associa a ID de 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 GUID alocado pelo chamador que armazena a ID de 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.

Retornar valor

FltPropagateActivityIdToThread retorna um dos seguintes valores 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 GUID apontado por OriginalId.

Comentários

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
Cliente mínimo com suporte Disponível a partir do Windows 8.
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua Fltkernel.h)
Biblioteca FltMgr.lib
DLL Fltmgr.sys
IRQL <= DISPATCH_LEVEL

Confira também

FltGetActivityIdCallbackData

FltSetActivityIdCallbackData