RxPostOneShotTimerRequest-Funktion (rxtimer.h)

  • Artikel

RxPostOneShotTimerRequest initialisiert einen Einmaligen Timereintrag. Der übergebene Zeiger auf eine Arbeitsthreadroutine wird einmal aufgerufen, wenn der Timer abläuft.

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

Parameter

[in] pDeviceObject

Ein Zeiger auf das Geräteobjekt, das diesem Timer zugeordnet werden soll.

[in] pWorkItem

Ein Zeiger auf das Workerelement.

[in] Routine

Ein Zeiger auf die Workerthreadroutine, die aufgerufen werden soll, wenn dieser Timer abläuft.

[in] pContext

Ein Zeiger auf den Kontextparameter, der diesem Timer zugeordnet ist.

[in] TimeInterval

Das Zeitintervall in 100-Nanosekunden-Ticks.

Rückgabewert

RxPostOneShotTimerRequest gibt STATUS_SUCCESS bei Erfolg zurück.

Wenn ein NULL-Zeiger als pWorkItem-Parameter übergeben wird, bewirkt diese Routine, dass das System bei überprüften Builds ASSERT erhält.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile rxtimer.h (include Rxtimer.h, Rxworkq.h)
IRQL <= APC_LEVEL

Weitere Informationen

RxCancelTimerRequest

RxPostRecurrentTimerRequest