WaitForThreadpoolIoCallbacks-Funktion (threadpoolapiset.h)

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

Siehe auch

CancelThreadpoolIo

CloseThreadpoolIo

CreateThreadpoolIo

StartThreadpoolIo

Threadpools