Функция CreateThreadpoolTimer (threadpoolapiset.h)

Создает новый объект таймера.

Синтаксис

PTP_TIMER CreateThreadpoolTimer(
  [in]                PTP_TIMER_CALLBACK   pfnti,
  [in, out, optional] PVOID                pv,
  [in, optional]      PTP_CALLBACK_ENVIRON pcbe
);

Параметры

[in] pfnti

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

[in, out, optional] pv

Необязательные данные, определяемые приложением, для передачи в функцию обратного вызова.

[in, optional] pcbe

Структура TP_CALLBACK_ENVIRON , определяющая среду, в которой выполняется обратный вызов. Функция InitializeThreadpoolEnvironment возвращает эту структуру.

Если этот параметр имеет значение NULL, обратный вызов выполняется в среде обратного вызова по умолчанию. Дополнительные сведения см. в разделе InitializeThreadpoolEnvironment.

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

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

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

Комментарии

Чтобы задать объект таймера, вызовите функцию SetThreadpoolTimer .

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0600 или выше.

Примеры

Пример см. в разделе Использование функций пула потоков.

Требования

См. также

CloseThreadpoolTimer

IsThreadpoolTimerSet

SetThreadpoolTimer

Пулы потоков

WaitForThreadpoolTimerCallbacks