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 |