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

Consulte también

IWDFIoRequest3

IWDFIoRequest3::RetrieveActivityId

WdfRequestSetActivityId