Método IWDFIoRequest3::SetActivityId (wudfddi.h)

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método SetActivityId associa um identificador de atividade a uma solicitação de E/S.

Sintaxe

void SetActivityId(
  [in] LPGUID ActivityId
);

Parâmetros

[in] ActivityId

Um ponteiro para o GUID do identificador de atividade a ser armazenado na solicitação de E/S.

Retornar valor

Nenhum

Comentários

Chamar SetActivityId não define uma associação com nenhum identificador de atividade presente anteriormente. Quando o driver chama SetActivityId, qualquer identificador de atividade existente é substituído.

Para definir uma associação, recupere o identificador existente chamando RetrieveActivityId e associe o identificador existente ao novo chamando EventWriteTransfer.

A estrutura não limpa o identificador de atividade de uma solicitação quando o driver chama IWdfIoRequest2::Reuse.

Para obter mais informações sobre identificadores de atividade, consulte Usando identificadores de atividade.

O equivalente umDF 2 desse método é WdfRequestSetActivityId.

Exemplos

Para obter um exemplo de código que usa SetActivityId, consulte RetrieveActivityId.

Requisitos

Confira também

IWDFIoRequest3

IWDFIoRequest3::RetrieveActivityId

WdfRequestSetActivityId