Compartir a través de

Función WdfRequestRetrieveActivityId (wdfrequest.h)

  • Artículo

[Solo se aplica a UMDF]

El método WdfRequestRetrieveActivityId recupera el identificador de actividad actual asociado a una solicitud de E/S.

Sintaxis

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

Parámetros

[in] Request

Identificador de un objeto de solicitud de marco.

[out] ActivityId

Puntero a una ubicación para almacenar el GUID recuperado.

Valor devuelto

Si la operación se realiza correctamente, WdfRequestRetrieveActivityId devuelve STATUS_SUCCESS. Entre los valores devueltos adicionales se incluyen:

Código devuelto Descripción
STATUS_NOT_FOUND
 No hay ningún identificador de actividad asociado a la solicitud.
 

El método podría devolver otros valores NTSTATUS.

Comentarios

Las solicitudes reflejadas desde el modo kernel tienen un identificador de actividad disponible solo si el proveedor de seguimiento del kernel está habilitado o si el controlador UMDF llamado WdfRequestSetActivityId después de recibir la solicitud. Para obtener más información sobre el seguimiento de eventos para Windows (ETW), consulte Seguimiento de eventos.

Las solicitudes iniciadas por el controlador UMDF tienen un identificador de actividad disponible solo si el controlador UMDF anteriormente llamado WdfRequestSetActivityId.

El marco de trabajo no borra el identificador de actividad de una solicitud cuando el controlador llama a WdfRequestReuse.

Para obtener más información sobre los identificadores de actividad, consulte Uso de identificadores de actividad.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1
Plataforma de destino Universal
Versión mínima de UMDF 2.0
Encabezado wdfrequest.h (incluya Wdf.h)
Library WUDFx02000.lib
Archivo DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

Consulte también

WdfRequestSetActivityId