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 |