Compartir a través de


Función TdhCleanupPayloadEventFilterDescriptor (tdh.h)

La función TdhCleanupPayloadEventFilterDescriptor libera la estructura agregada de filtros de carga creados mediante la función TdhAggregatePayloadFilters .

Sintaxis

TDHSTATUS TdhCleanupPayloadEventFilterDescriptor(
  [in, out] PEVENT_FILTER_DESCRIPTOR EventFilterDescriptor
);

Parámetros

[in, out] EventFilterDescriptor

Puntero a una estructura de EVENT_FILTER_DESCRIPTOR que contiene filtros agregados donde se va a liberar la memoria asignada. La estructura de EVENT_FILTER_DESCRIPTOR pasada se creó llamando a la función TdhAggregatePayloadFilters .

Si la llamada se realiza correctamente, se libera memoria asignada para los filtros agregados y se vuelven a inicializar los campos de la estructura de EVENT_FILTER_DESCRIPTOR devuelta.

Valor devuelto

Devuelve ERROR_SUCCESS si se ejecuta correctamente. De lo contrario, esta función devuelve uno de los siguientes códigos de retorno además de otros.

Código devuelto Descripción
ERROR_INVALID_PARAMETER
Uno o varios de los parámetros no son válidos.

Comentarios

En Windows 8.1,Windows Server 2012 R2 y versiones posteriores, la función EnableTraceEx2 puede usar filtros de carga de eventos para filtrar por contenido específico del evento en una sesión de registrador.

La función TdhCleanupPayloadEventFilterDescriptor se usa para liberar memoria asignada que devuelve la función TdhAggregatePayloadFilters .

Ejemplos

Para obtener un ejemplo que usa la función TdhCleanupPayloadEventFilterDescriptor para liberar memoria usada por filtros de carga agregado, vea el ejemplo de la función EnableTraceEx2 .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado tdh.h
Library Tdh.lib
Archivo DLL Tdh.dll

Consulte también

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTraceEx2

TdhAggregatePayloadFilters

TdhCreatePayloadFilter

TdhDeletePayloadFilter