Функция WaitForThreadpoolIoCallbacks (threadpoolapiset.h)
Ожидает завершения невыполненных обратных вызовов завершения ввода-вывода и при необходимости отменяет ожидающие обратные вызовы, которые еще не начали выполняться.
Синтаксис
void WaitForThreadpoolIoCallbacks(
[in, out] PTP_IO pio,
[in] BOOL fCancelPendingCallbacks
);
Параметры
[in, out] pio
Указатель на структуру TP_IO , которая определяет объект завершения ввода-вывода. Функция CreateThreadpoolIo возвращает этот указатель.
[in] fCancelPendingCallbacks
Указывает, следует ли отменять обратные вызовы в очереди, которые еще не начали выполняться.
Возвращаемое значение
None
Remarks
Если параметр fCancelPendingCallbacks имеет значение TRUE, отменяются только обратные вызовы в очереди. Ожидающие запросы ввода-вывода не отменяются. Поэтому вызывающий объект должен вызвать Метод GetOverlappedResult для структуры OVERLAPPED, чтобы проверка, завершена ли операция ввода-вывода перед освобождением структуры. В качестве альтернативы присвойте fCancelPendingCallbacks значение FALSE и освободите соответствующую функцию обратного вызова завершения ввода-вывода для структуры OVERLAPPED . Будьте осторожны, чтобы не освободить структуру OVERLAPPED , пока запросы ввода-вывода все еще находятся в состоянии ожидания; используйте GetOverlappedResult , чтобы определить состояние операции ввода-вывода и дождаться ее завершения. Функция CancelIoEx может быть использована сначала для отмены невыполненных запросов ввода-вывода, что может сократить время ожидания. Дополнительные сведения см. в разделе Отмена ожидающих операций ввода-вывода.
Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0600 или выше.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [классические приложения | Приложения UWP] |
Минимальная версия сервера | Windows Server 2008 [классические приложения | Приложения UWP] |
Целевая платформа | Windows |
Header | threadpoolapiset.h (включает Windows.h в Windows 7, Windows Server 2008 Windows Server 2008 R2) |
Библиотека | Kernel32.lib |
DLL | Kernel32.dll |