Função WdfRequestRetrieveActivityId (wdfrequest.h)

  • Artigo

[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.

Retornar valor

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

Código de retorno Descrição
STATUS_NOT_FOUND
 Nenhuma ID de atividade está associada à solicitação.
 

O método pode retornar outros valores NTSTATUS.

Comentários

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 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

Requisito Valor
Cliente mínimo com suporte Windows 8.1
Plataforma de Destino Universal
Versão mínima do UMDF 2,0
Cabeçalho wdfrequest.h (inclua Wdf.h)
Biblioteca WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

Confira também

WdfRequestSetActivityId