PTIMERAPCROUTINE-Rückruffunktion (synchapi.h)
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) |