RxPostRecurrentTimerRequest-Funktion (rxtimer.h)

  • Artikel

RxPostRecurrentTimerRequest initialisiert eine wiederkehrende Timeranforderung. Die im Zeiger an eine Workerthreadroutine übergebene Routine wird in regelmäßigen Abständen aufgerufen, wenn der wiederkehrende Timer basierend auf den Eingabeparametern für diese Routine ausgelöst wird.

Syntax

NTSTATUS RxPostRecurrentTimerRequest(
  [in] IN PRDBSS_DEVICE_OBJECT     pDeviceObject,
  [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] 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 werden soll.

[in] TimeInterval

Das Zeitintervall in 100-Nanosekunden-Ticks.

Rückgabewert

RxPostRecurrentTimerRequest gibt bei Erfolg STATUS_SUCCESS oder einen der folgenden Fehlercodes zurück:

Rückgabecode Beschreibung
STATUS_INSUFFICIENT_RESOURCES
 Fehler bei der Zuordnung des nicht ausgelagerten Poolspeichers, der für diese Routine erforderlich ist.

Hinweise

Ein wiederkehrender Timer kann durch Aufrufen von RxCancelTimerRequest abgebrochen werden.

Anforderungen

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

Weitere Informationen

RxCancelTimerRequest

RxPostOneShotTimerRequest