RxPostOneShotTimerRequest routine

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_ PRDBSS_DEVICE_OBJECT     pDeviceObject,
  _In_ PRX_WORK_ITEM            pWorkItem,
  _In_ PRX_WORKERTHREAD_ROUTINE Routine,
  _In_ PVOID                    pContext,
  _In_ LARGE_INTEGER            TimeInterval
);

Parameters

pDeviceObject [in]

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

pWorkItem [in]

A pointer to the worker item.

Routine [in]

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

pContext [in]

A pointer to the context parameter associated with this timer.

TimeInterval [in]

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

Target platform

Desktop

Header

Rxtimer.h (include Rxtimer.h or Rxworkq.h)

IRQL

<= APC_LEVEL

See also

RxCancelTimerRequest
RxPostRecurrentTimerRequest

 

 

Send comments about this topic to Microsoft

Show: