Função EtwWriteTransfer (wdm.h)

A função EtwWriteTransfer marca um evento que vincula duas atividades; esse tipo de evento é conhecido como um evento de transferência. Um evento de transferência pode conter os mesmos dados definidos pelo usuário, os mesmos campos e está sujeito às mesmas regras que outros eventos.

Sintaxe

NTSTATUS EtwWriteTransfer(
  [in]           REGHANDLE              RegHandle,
  [in]           PCEVENT_DESCRIPTOR     EventDescriptor,
  [in, optional] LPCGUID                ActivityId,
  [in, optional] LPCGUID                RelatedActivityId,
  [in]           ULONG                  UserDataCount,
  [in, optional] PEVENT_DATA_DESCRIPTOR UserData
);

Parâmetros

[in] RegHandle

Um ponteiro para o identificador de registro do provedor de eventos, que será retornado pela função EtwRegister se o registro do provedor de eventos for bem-sucedido.

[in] EventDescriptor

Um ponteiro para a estrutura EVENT_DESCRIPTOR.

[in, optional] ActivityId

O identificador que indica a atividade associada ao evento. A ActivityId fornece uma maneira de agrupar eventos relacionados e é usada no rastreamento de ponta a ponta. Esse identificador é opcional e pode ser NULL.

[in, optional] RelatedActivityId

O identificador que indica a atividade relacionada associada ao evento. O RelatedActivityID fornece uma maneira de agrupar eventos relacionados e é usado no rastreamento de ponta a ponta.

[in] UserDataCount

O número de elementos em uma matriz de estruturas EVENT_DATA_DESCRIPTOR.

[in, optional] UserData

O ponteiro para o primeiro elemento em uma matriz de estruturas EVENT_DATA_DESCRIPTOR.

Retornar valor

EtwWriteTransfer retornará STATUS_SUCCESS se o evento tiver sido publicado com êxito.

Comentários

Você pode chamar EtwWriteTransfer em qualquer IRQL. No entanto, quando IRQL é maior que APC_LEVEL, todos os dados passados para as funções EtwWrite, EtwWriteString, EtwWriteTransfer não devem ser pagináveis. Ou seja, qualquer rotina de modo kernel em execução no IRQL maior que APC_LEVEL não pode acessar a memória paginável. Os dados passados para as funções EtwWrite, EtwWriteString, EtwWriteTransfer devem residir na memória do espaço do sistema, independentemente do que seja o IRQL.

Requisitos

Confira também

EtwWrite

EtwWriteString