PulseEvent

BOOL PulseEvent( HANDLE hEvent );

Возвращаемое значение

Ненулевое, если работа функции завершилась успешно. Если в процессе работы функции возникла ошибка, возвращается нулевое значение. Более подробную информацию об ошибке можно получить, вызвав функцию GetLastError.

Аргументы

0. hEvent — Дескриптор объекта события, возвращённый функцией CreateEvent или OpenEvent. В Windows NT этот аргумент должен иметь уровень доступа EVENT_MODIFY_STATE.

Примечание

Функция PulseEvent служит для установки в отмеченное состояние указанного объекта события, и последующего сброса его в неотмеченное состояние после запуска определённого числа ожидающих потоков.

Для объектов событий, созданных в режиме ручного сброса, все ожидающие потоки, которые могут быть немедленно запущены, запускаются на исполнение. После этого функция сбрасывает объект события в неотмеченное состояние и завершает свою работу.

Для объектов событий, созданных в режиме автоматического сброса, функция запускает один ожидающий поток, даже в том случае, когда в режиме ожидания находится несколько потоков, сбрасывает объект события в неотмеченное состояние и завершает свою работу.

Если в приложении отсутствуют ожидающие потоки, функция PulseEvent просто, сбрасывает объект события в неотмеченное состояние и завершает свою работу.

В случае использования функций ожидания, работающих с несколькими объектами события и настроенными на срабатывание по установке всех этих объектов в отмеченное состояние, функция PulseEvent сбросит отмеченное состояние объекта события независимо от того, сработала данная функция или нет.

Описание данной функции содержится в файле заголовка winbase.h. При работе с данной функцией следует включить в проект библиотеку kernel32.lib.

QueryPerformanceCounter

BOOL QueryPerformanceCounter( LARGE_INTEGER *lpPerformanceCount );

Возвращаемое значение

Если установленное аппаратное обеспечение позволяет использовать счётчики высокой точности, возвращается ненулевое значение. В противном случае возвращается нулевое значение.

Аргументы

0. lpPerformanceCount — указатель на переменную, в которую функция заносит текущее значение высокоточного счётчика. Если установленное аппаратное обеспечение не позволяет использовать счётчики высокой точности, данный аргумент может иметь нулевое значение.

Примечание

Функция QueryPerformanceCounter позволяет получить текущее значение высокоточного счётчика, если он существует.

Описание данной функции содержится в файле заголовка winbase.h. При работе с данной функцией следует включить в проект библиотеку kernel32.lib.

QueryPerformanceFrequency

BOOL QueryPerformanceFrequency( LARGE_INTEGER *lpFrequency );

Возвращаемое значение

Если установленное аппаратное обеспечение позволяет использовать счётчики высокой точности, возвращается ненулевое значение. В противном случае возвращается нулевое значение.

Аргументы

0. lpFrequency — указатель на переменную, в которую функция заносит число тактов высокоточного счётчика в секунду. Если установленное аппаратное обеспечение не позволяет использовать счётчики высокой точности, данный аргумент может иметь нулевое значение.

Примечание

Функция QueryPerformanceFrequency позволяет получить число тактов высокоточного счётчика в секунду.

Описание данной функции содержится в файле заголовка winbase.h. При работе с данной функцией следует включить в проект библиотеку kernel32.lib.