RxPostRecurrentTimerRequest function

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 PRDBSS_DEVICE_OBJECT     pDeviceObject,
  IN PRX_WORKERTHREAD_ROUTINE Routine,
  IN PVOID                    pContext,
  IN LARGE_INTEGER            TimeInterval
);

Parameters

pDeviceObject

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

Routine

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

pContext

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

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

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

See Also

RxCancelTimerRequest

RxPostOneShotTimerRequest