Edit

RxPostOneShotTimerRequest function (rxtimer.h)

  • Article

RxPostOneShotTimerRequest initializes a one-shot timer entry. The passed-in pointer to a worker thread routine is called once when the timer expires.

Syntax

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
);

Parameters

[in] pDeviceObject

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

[in] pWorkItem

A pointer to the worker item.

[in] Routine

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

[in] pContext

A pointer to the context parameter associated with this timer.

[in] TimeInterval

The time interval, in 100-nanosecond ticks.

Return value

RxPostOneShotTimerRequest returns STATUS_SUCCESS on success.

If a NULL pointer is passed as the pWorkItem parameter, this routine causes the system to ASSERT on checked builds.

Requirements

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

See also

RxCancelTimerRequest

RxPostRecurrentTimerRequest