Función WdfRequestRetrieveActivityId (wdfrequest.h)
[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 |
|---|---|
|
No hay ningún identificador de actividad asociado a la solicitud. |
El método podría devolver otros valores ntstatus de .
Observaciones
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 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 Using Activity Identifiers (Uso de identificadores de actividad).
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 8.1 |
| de la plataforma de destino de | Universal |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfrequest.h (incluya Wdf.h) |
| biblioteca de | WUDFx02000.lib |
| DLL de | WUDFx02000.dll |
| irQL | PASSIVE_LEVEL |