Função IoSetActivityIdIrp (ntddk.h)

A rotina IoSetActivityIdIrp associa uma ID de atividade a um IRP.

Sintaxe

NTSTATUS IoSetActivityIdIrp(
  [in]           PIRP    Irp,
  [in, optional] LPCGUID Guid
);

Parâmetros

[in] Irp

O IRP ao qual associar a ID da atividade.

[in, optional] Guid

Um ponteiro para o GUID que representa a ID a ser armazenada no IRP. Se NULL, IoSetActivityIdIrp tentará recuperar a ID da atividade do thread atual se for o thread que originalmente emitiu a solicitação.

Valor de retorno

IoSetActivityIdIrp retorna STATUS_SUCCESS se a chamada for bem-sucedida. Os valores de retorno de erro possíveis incluem o seguinte.

Código de retorno	Descrição
STATUS_NOT_SUPPORTED	Nenhum GUID foi fornecido e a ID da atividade ETW não estava disponível.
STATUS_UNSUCCESSFUL	O provedor de rastreamento de E/S não foi habilitado no IRP.

Observações

Os drivers devem usar IoSetActivityIdIrp somente em IRPs que foram alocados usando IoAllocateIrp (e liberados usando IoFreeIrp). Caso contrário, o vazamento de memória poderá resultar.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 8.
da Plataforma de Destino	Universal
cabeçalho	ntddk.h (inclua Ntddk.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	Qualquer nível se um GUID for passado, caso contrário, PASSIVE_LEVEL.