Share via

PTIMERAPCROUTINE-Rückruffunktion (synchapi.h)

  • Artikel

Eine anwendungsdefinierte Zeitgeber-Abschlussroutine. Geben Sie diese Adresse an, wenn Sie die SetWaitableTimer-Funktion aufrufen. Der PTIMERAPCROUTINE-Typ definiert einen Zeiger auf diese Rückruffunktion. TimerAPCProc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PTIMERAPCROUTINE Ptimerapcroutine;

void Ptimerapcroutine(
  [in, optional] LPVOID lpArgToCompletionRoutine,
  [in]           DWORD dwTimerLowValue,
  [in]           DWORD dwTimerHighValue
)
{...}

Parameter

[in, optional] lpArgToCompletionRoutine

Der Wert, der mithilfe des lpArgToCompletionRoutine-Parameters der SetWaitableTimer-Funktion an die Funktion übergeben wird.

[in] dwTimerLowValue

Der Teil der niedrigen Reihenfolge der UTC-basierten Zeit, zu der der Timer signalisiert wurde. Dieser Wert entspricht dem dwLowDateTime-Element der FILETIME-Struktur . Weitere Informationen zur UTC-basierten Zeit finden Sie unter Systemzeit.

[in] dwTimerHighValue

Der hohe Teil der UTC-basierten Zeit, zu der der Timer signalisiert wurde. Dieser Wert entspricht dem dwHighDateTime-Element der FILETIME-Struktur .

Rückgabewert

Keine

Bemerkungen

Die Vervollständigungsroutine wird von dem Thread ausgeführt, der den Timer mithilfe von SetWaitableTimer aktiviert. Der Thread muss sich jedoch in einem warnbaren Zustand befinden. Weitere Informationen finden Sie unter Asynchrone Prozeduraufrufe.

Beispiele

Ein Beispiel finden Sie unter Verwenden eines wartebaren Timers mit einem asynchronen Prozeduraufruf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile synchapi.h (windows.h einschließen)

Weitere Informationen

SetWaitableTimer