Compartilhar via


Função QueryProcessCycleTime (realtimeapiset.h)

Recupera a soma do tempo de ciclo de todos os threads do processo especificado.

Sintaxe

BOOL QueryProcessCycleTime(
  [in]  HANDLE   ProcessHandle,
  [out] PULONG64 CycleTime
);

Parâmetros

[in] ProcessHandle

Um identificador para o processo. O identificador deve ter o acesso PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION direito. Para obter mais informações, consulte Process Security and Access Rights.

[out] CycleTime

O número de ciclos de relógio de CPU usados pelos threads do processo. Esse valor inclui ciclos gastos no modo de usuário e no modo kernel.

Valor de retorno

Se a função for bem-sucedida, o valor retornado não será zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Observações

Para enumerar os processos no sistema, use a função EnumProcesses.

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou posterior.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho realtimeapiset.h (inclua Windows.h no Windows 7, Windows Server 2008 Windows Server 2008 R2)
biblioteca Mincore.lib
de DLL Kernel32.dll

Consulte também

QueryIdleProcessorCycleTime

QueryThreadCycleTime