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

  • Artículo

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

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

Sintaxis

HRESULT RetrieveActivityId(
  [out] LPGUID ActivityId
);

Parámetros

[out] ActivityId

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

Valor devuelto

RetrieveActivityId devuelve S_OK si la llamada se realiza correctamente. De lo contrario, este método podría devolver uno de los valores siguientes.

Código devuelto Descripción
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
 No hay ningún identificador de actividad asociado a la solicitud.

Comentarios

Las solicitudes reflejadas desde el modo kernel tienen un identificador de actividad disponible solo si el proveedor de seguimiento de kernel está habilitado o si el controlador UMDF llamado IWDFIoRequest3::SetActivityId 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 IWDFIoRequest3::SetActivityId.

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

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

El equivalente de UMDF 2 de este método es WdfRequestRetrieveActivityId.

Ejemplos

En el ejemplo de código siguiente se muestra que un controlador puede recuperar un identificador de actividad de una solicitud y, a continuación, usarlo para establecer el identificador de actividad para otra solicitud.

hrQI = pWdfRequest->QueryInterface(IID_PPV_ARGS(&pOriginalRequest3));
ASSERT(SUCCEEDED(hrQI));

hrQI = pNewRequest->QueryInterface(IID_PPV_ARGS(&pNewRequest3));
ASSERT(SUCCEEDED(hrQI));

//
// Obtain activity id from original request and set in the new one
//

pOriginalRequest3->RetrieveActivityId(&activityId);
pNewRequest3->SetActivityId(&activityId);

pOriginalRequest3->Release();
pNewRequest3->Release();

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1.11
Encabezado wudfddi.h (incluya Wudfddi.h)
Archivo DLL WUDFx.dll

Consulte también

IWDFIoRequest3

IWDFIoRequest3::SetActivityId