WaitForThreadpoolIoCallbacks-Funktion (threadpoolapiset.h)

Artikel
08/26/2023

Wartet, bis ausstehende E/A-Abschlussrückrufe abgeschlossen sind, und bricht optional ausstehende Rückrufe ab, die noch nicht gestartet wurden.

Syntax

void WaitForThreadpoolIoCallbacks(
  [in, out] PTP_IO pio,
  [in]      BOOL   fCancelPendingCallbacks
);

Parameter

[in, out] pio

Ein Zeiger auf eine TP_IO-Struktur , die das E/A-Vervollständigungsobjekt definiert. Die CreateThreadpoolIo-Funktion gibt diesen Zeiger zurück.

[in] fCancelPendingCallbacks

Gibt an, ob Rückrufe in der Warteschlange abgebrochen werden sollen, die noch nicht mit der Ausführung begonnen haben.

Rückgabewert

Keine

Bemerkungen

Wenn fCancelPendingCallbacks auf TRUE festgelegt ist, werden nur Rückrufe in der Warteschlange abgebrochen. Ausstehende E/A-Anforderungen werden nicht abgebrochen. Daher sollte der Aufrufer GetOverlappedResult für die OVERLAPPED-Struktur aufrufen, um zu überprüfen, ob der E/A-Vorgang abgeschlossen wurde, bevor die Struktur freigegeben wird. Legen Sie alternativ fCancelPendingCallbacks auf FALSE fest, und lassen Sie den zugeordneten E/A-Abschlussrückruf die OVERLAPPED-Struktur frei. Achten Sie darauf, die OVERLAPPED-Struktur nicht freizulassen, während E/A-Anforderungen noch ausstehen. Verwenden Sie GetOverlappedResult, um die status des E/A-Vorgangs zu bestimmen und zu warten, bis der Vorgang abgeschlossen ist. Die CancelIoEx-Funktion kann optional zuerst verwendet werden, um ausstehende E/A-Anforderungen abzubrechen, wodurch die Wartezeit möglicherweise verkürzt wird. Weitere Informationen finden Sie unter Abbrechen ausstehender E/A-Vorgänge.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	threadpoolapiset.h (Einschließen von Windows.h unter Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch