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.

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