Método IWDFIoRequest3::RetrieveActivityId (wudfddi.h)
[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 |
|---|---|
|
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 |