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 FOR NULL, IoSetActivityIdIrp tentará recuperar a ID da atividade do thread atual se for o thread que originalmente emitiu a solicitação.

Retornar valor

IoSetActivityIdIrp retornará STATUS_SUCCESS se a chamada for bem-sucedida. Possíveis valores retornados por erro 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.

Comentários

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
Cliente mínimo com suporte	Disponível a partir do Windows 8.
Plataforma de Destino	Universal
Cabeçalho	ntddk.h (inclua Ntddk.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Qualquer nível se um GUID for passado, caso contrário, PASSIVE_LEVEL.