Функция RxPostOneShotTimerRequest (rxtimer.h)

Статья
02/29/2024

RxPostOneShotTimerRequest инициализирует однократную запись таймера. Переданный указатель на подпрограмму рабочего потока вызывается один раз по истечении срока действия таймера.

Синтаксис

NTSTATUS RxPostOneShotTimerRequest(
  [in] IN PRDBSS_DEVICE_OBJECT     pDeviceObject,
  [in] IN PRX_WORK_ITEM            pWorkItem,
  [in] IN PRX_WORKERTHREAD_ROUTINE Routine,
  [in] IN PVOID                    pContext,
  [in] IN LARGE_INTEGER            TimeInterval
);

Параметры

[in] pDeviceObject

Указатель на объект устройства, связанный с этим таймером.

[in] pWorkItem

Указатель на элемент рабочей роли.

[in] Routine

Указатель на подпрограмму рабочего потока, вызываемую по истечении срока действия таймера.

[in] pContext

Указатель на параметр контекста, связанный с этим таймером.

[in] TimeInterval

Интервал времени в 100-наносекундных тактов.

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

RxPostOneShotTimerRequest возвращает STATUS_SUCCESS при успешном выполнении.

Если в качестве параметра pWorkItem передается указатель NULL, эта подпрограмма приводит к тому, что система будет использовать ASSERT в проверенных сборках.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	rxtimer.h (включая Rxtimer.h, Rxworkq.h)
IRQL	<= APC_LEVEL

См. также раздел

RxCancelTimerRequest

RxPostRecurrentTimerRequest

Share via