Edit

RxPostRecurrentTimerRequest function (rxtimer.h)

  • Article

RxPostRecurrentTimerRequest initializes a recurrent timer request. The passed in pointer to a worker thread routine is called at regular intervals when the recurrent timer fires based on the input parameters to this routine.

Syntax

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

Parameters

[in] pDeviceObject

A pointer to the device object to be associated with this timer.

[in] Routine

A pointer to the worker thread routine to call when this timer expires.

[in] pContext

A pointer to the context parameter to be associated with this timer.

[in] TimeInterval

The time interval, in 100-nanosecond ticks.

Return value

RxPostRecurrentTimerRequest returns STATUS_SUCCESS on success or one of the following error codes:

Return code Description
STATUS_INSUFFICIENT_RESOURCES
 The allocation of non-paged pool memory required by this routine failed.

Remarks

A recurrent timer can be canceled by calling RxCancelTimerRequest.

Requirements

Requirement Value
Target Platform Desktop
Header rxtimer.h (include Rxtimer.h, Rxworkq.h)
IRQL <= APC_LEVEL

See also

RxCancelTimerRequest

RxPostOneShotTimerRequest