Функция WaitForThreadpoolIoCallbacks (threadpoolapiset.h)

Статья
08/26/2023

Ожидает завершения невыполненных обратных вызовов завершения ввода-вывода и при необходимости отменяет ожидающие обратные вызовы, которые еще не начали выполняться.

Синтаксис

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