Método IWDFIoRequest3::SetActivityId (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 SetActivityId asocia un identificador de actividad a una solicitud de E/S.
Sintaxis
void SetActivityId(
[in] LPGUID ActivityId
);
Parámetros
[in] ActivityId
Puntero al GUID del identificador de actividad que se va a almacenar en la solicitud de E/S.
Valor devuelto
None
Observaciones
La llamada a SetActivityId no establece una asociación con ningún identificador de actividad presente anteriormente. Cuando el controlador llama a SetActivityId, se sobrescribe cualquier identificador de actividad existente.
Para establecer una asociación, recupere el identificador existente llamando a RetrieveActivityId y, a continuación, asocie el identificador existente con el nuevo llamando a EventWriteTransfer.
El marco 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 UMDF 2 de este método es WdfRequestSetActivityId.
Ejemplos
Para obtener un ejemplo de código que usa SetActivityId, consulte RetrieveActivityId.
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 |