Partilhar via

Função IoSetActivityIdIrp (ntddk.h)

  • Artigo

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.