RxCancelTimerRequest-Funktion (rxtimer.h)

  • Artikel

RxCancelTimerRequest bricht eine wiederkehrende Zeitgeberanforderung ab. Die abgebrochene Anforderung wird durch die Arbeitsthreadroutine und den zugeordneten Kontext identifiziert.

Syntax

NTSTATUS RxCancelTimerRequest(
  [in] IN PRDBSS_DEVICE_OBJECT     pDeviceObject,
  [in] IN PRX_WORKERTHREAD_ROUTINE Routine,
  [in] IN PVOID                    pContext
);

Parameter

[in] pDeviceObject

Ein Zeiger auf das Geräteobjekt, das den Timer initialisiert hat. Dieser Parameter wurde an die RxPostRecurrentTimerRequest-Routine übergeben, als dieser wiederkehrende Timer initialisiert wurde.

[in] Routine

Ein Zeiger auf die Workerthreadroutine, die aufgerufen werden soll, wenn dieser Timer abläuft. Dieser Parameter wurde an die RxPostRecurrentTimerRequest-Routine übergeben, als dieser wiederkehrende Timer initialisiert wurde.

[in] pContext

Ein Zeiger auf den Kontextparameter, der bei der Initialisierung dieses Timers an die RxPostRecurrentTimerRequest-Routine übergeben wurde.

Rückgabewert

RxCancelTimerRequest gibt bei Erfolg STATUS_SUCCESS zurück.

Hinweise

Ein wiederkehrender Timer wird durch Aufrufen von RxPostRecurrentTimerRequest initialisiert.

Wenn der wiederkehrende Timer nicht gefunden wird, gibt diese Routine STATUS_NOT_FOUND zurück.

Anforderungen

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

Weitere Informationen

RxPostOneShotTimerRequest

RxPostRecurrentTimerRequest