Função FltSetActivityIdCallbackData (fltkernel.h)

Artigo
03/05/2024

A rotina FltSetActivityIdCallbackData define a ID da atividade de um IRP em dados de retorno de chamada de um minifiltro.

Sintaxe

NTSTATUS FLTAPI FltSetActivityIdCallbackData(
  [in, out]      PFLT_CALLBACK_DATA CallbackData,
  [in, optional] LPCGUID            Guid
);

Parâmetros

[in, out] CallbackData

Um ponteiro para os dados de retorno de chamada que contêm a solicitação com uma ID de atividade associada.

[in, optional] Guid

Um ponteiro opcional para a estrutura GUID que recebe a ID da atividade. Se Guid for NULL, o sistema tentará atribuir uma ID de atividade ETW para a solicitação.

Retornar valor

FltSetActivityIdCallbackData 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. -ou- O GUID apontado por Guid não foi fornecido e nenhuma ID de atividade etw está disponível ou a operação.
STATUS_NOT_FOUND	Nenhuma ID de atividade está associada à solicitação em CallbackData.
STATUS_SUCCESS	Uma ID de atividade apontada por Guid foi definida para o IRP em CallbackData.

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.

-ou-

O GUID apontado por Guid não foi fornecido e nenhuma ID de atividade etw está disponível ou a operação.

STATUS_NOT_FOUND

Nenhuma ID de atividade está associada à solicitação em CallbackData.

STATUS_SUCCESS

Uma ID de atividade apontada por Guid foi definida para o IRP em CallbackData.

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

FltPropagateActivityIdToThread

Partilhar via