Funzione EnableThreadProfiling (winbase.h)

Articolo
03/13/2024

Abilita la profilatura del thread nel thread specificato.

Sintassi

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

Parametri

[in] ThreadHandle

Handle al thread in cui si vuole abilitare la profilatura. Questo deve essere il thread corrente.

[in] Flags

Per ricevere i dati di profilatura del thread, ad esempio il conteggio dei commutatori di contesto, impostare questo parametro su THREAD_PROFILING_FLAG_DISPATCH; in caso contrario, impostare su 0.

[in] HardwareCounters

Per ricevere i dati del contatore delle prestazioni hardware, impostare questo parametro su una maschera bit che identifica i contatori hardware da raccogliere. È possibile specificare fino a 16 contatori delle prestazioni. Ogni bit si riferisce direttamente all'indice del contatore hardware in base zero per i contatori delle prestazioni hardware configurati. Impostare su zero se non si raccolgono dati del contatore hardware. Se si imposta un bit per un contatore hardware non configurato, il valore del contatore letto per tale contatore è zero.

[out] PerformanceDataHandle

Handle opaco usato quando si chiamano le funzioni ReadThreadProfilingData e DisableThreadProfiling .

Valore restituito

Restituisce ERROR_SUCCESS se la chiamata ha esito positivo; in caso contrario, un codice di errore di sistema (vedere Winerror.h).

Commenti

È necessario chiamare la funzione DisableThreadProfiling prima di uscire dal thread.

Per profilare i contatori delle prestazioni hardware, è necessario un driver per configurare i contatori. I contatori delle prestazioni sono configurati a livello globale per il sistema, quindi ogni thread ha accesso agli stessi dati del contatore hardware. I contatori devono essere configurati prima di abilitare la profilatura. Per informazioni sulla configurazione dei contatori delle prestazioni hardware, vedere la funzione KeSetHardwareCounterConfiguration in Windows Driver Kit (WDK).

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

DisableThreadProfiling

QueryThreadProfiling

ReadThreadProfilingData

Condividi tramite