Función EnableThreadProfiling (winbase.h)

Habilita la generación de perfiles de subprocesos en el subproceso especificado.

Sintaxis

DWORD EnableThreadProfiling(
  [in]  HANDLE  ThreadHandle,
  [in]  DWORD   Flags,
  [in]  DWORD64 HardwareCounters,
  [out] HANDLE  *PerformanceDataHandle
);

Parámetros

[in] ThreadHandle

Identificador del subproceso en el que desea habilitar la generación de perfiles. Debe ser el subproceso actual.

[in] Flags

Para recibir datos de generación de perfiles de subprocesos como recuento de conmutadores de contexto, establezca este parámetro en THREAD_PROFILING_FLAG_DISPATCH; de lo contrario, establezca en 0.

[in] HardwareCounters

Para recibir datos del contador de rendimiento de hardware, establezca este parámetro en una máscara de bits que identifique los contadores de hardware que se van a recopilar. Puede especificar hasta 16 contadores de rendimiento. Cada bit se relaciona directamente con el índice de contadores de hardware de base cero para los contadores de rendimiento de hardware que configuró. Establezca en cero si no recopila datos de contadores de hardware. Si establece un bit para un contador de hardware que no se ha configurado, el valor del contador que se lee para ese contador es cero.

[out] PerformanceDataHandle

Identificador opaco que se usa al llamar a las funciones ReadThreadProfilingData y DisableThreadProfiling .

Valor devuelto

Devuelve ERROR_SUCCESS si la llamada es correcta; de lo contrario, un código de error del sistema (consulte Winerror.h).

Comentarios

Debe llamar a la función DisableThreadProfiling antes de salir del subproceso.

Para generar perfiles de contadores de rendimiento de hardware, necesita un controlador para configurar los contadores. Los contadores de rendimiento se configuran globalmente para el sistema, por lo que cada subproceso tiene acceso a los mismos datos del contador de hardware. Los contadores deben configurarse antes de habilitar la generación de perfiles. Para obtener información sobre cómo configurar contadores de rendimiento de hardware, consulta la función KeSetHardwareCounterConfiguration en el Kit de controladores de Windows (WDK).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

DisableThreadProfiling

QueryThreadProfiling

ReadThreadProfilingData