Функция QueryThreadCycleTime (realtimeapiset.h)
Извлекает время цикла для указанного потока.
Синтаксис
BOOL QueryThreadCycleTime(
[in] HANDLE ThreadHandle,
[out] PULONG64 CycleTime
);
Параметры
[in] ThreadHandle
Дескриптор потока. Дескриптор должен иметь право доступа PROCESS_QUERY_INFORMATION или PROCESS_QUERY_LIMITED_INFORMATION. Дополнительные сведения см. в "Безопасность процессов и доступ".
[out] CycleTime
Количество циклов часов ЦП, используемых потоком. Это значение включает циклы, потраченные как в пользовательском режиме, так и в режиме ядра.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение ненулевое.
Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Чтобы перечислить потоки процесса, используйте функции Thread32First и Thread32Next. Чтобы получить дескриптор потока для идентификатора потока, используйте функцию OpenThread.
Не пытайтесь преобразовать циклы часов ЦП, возвращаемые QueryThreadCycleTime в истекшее время. Эта функция использует службы таймера, предоставляемые ЦП, которые могут отличаться в реализации. Например, некоторые ЦП будут различать частоту таймера при изменении частоты запуска ЦП, а другие будут оставлять его с фиксированной скоростью. Поведение каждого ЦП описано в документации, предоставленной поставщиком ЦП.
Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0600 или более поздней версии.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista [только классические приложения] |
| минимальный поддерживаемый сервер | Windows Server 2008 [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | realtimeapiset.h (включая Windows.h в Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| библиотеки |
Mincore.lib |
| DLL | Kernel32.dll |