Função WdfRequestRetrieveActivityId (wdfrequest.h)

[Aplica-se somente ao UMDF]

O método WdfRequestRetrieveActivityId recupera o identificador de atividade atual associado a uma solicitação de E/S.

Sintaxe

NTSTATUS WdfRequestRetrieveActivityId(
  [in]  WDFREQUEST Request,
  [out] LPGUID     ActivityId
);

Parâmetros

[in] Request

Um identificador para um objeto de solicitação de estrutura.

[out] ActivityId

Um ponteiro para um local para armazenar o GUID recuperado.

Valor de retorno

Se a operação for bem-sucedida, WdfRequestRetrieveActivityId retornará STATUS_SUCCESS. Os valores de retorno adicionais incluem:

O método pode retornar outros valores NTSTATUS .

Observações

As solicitações refletidas do modo kernel têm um identificador de atividade disponível somente se o provedor de Rastreamento de Kernel estiver habilitado ou se o driver UMDF chamado WdfRequestSetActivityId após receber a solicitação. Para obter mais informações sobre o ETW (Rastreamento de Eventos para Windows), consulte de Rastreamento de Eventos.

As solicitações iniciadas pelo driver UMDF têm um identificador de atividade disponível somente se o driver UMDF anteriormente chamado WdfRequestSetActivityId.

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

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

Requisitos

Consulte também

WdfRequestSetActivityId