Поделиться через


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

Уведомляет пул потоков о возможном начале операций ввода-вывода для указанного объекта завершения ввода-вывода. Рабочий поток вызывает функцию обратного вызова объекта завершения ввода-вывода после завершения операции в дескрипторе файла, привязанном к этому объекту.

Синтаксис

void StartThreadpoolIo(
  [in, out] PTP_IO pio
);

Параметры

[in, out] pio

Указатель на структуру TP_IO , которая определяет объект завершения ввода-вывода. Функция CreateThreadpoolIo возвращает этот указатель.

Возвращаемое значение

None

Remarks

Эту функцию необходимо вызвать перед запуском каждой асинхронной операции ввода-вывода в дескрипторе файла, привязанном к объекту завершения ввода-вывода. В этом случае пул потоков будет игнорировать операцию ввода-вывода после ее завершения, что приведет к повреждению памяти.

Если операция ввода-вывода завершается сбоем, вызовите функцию CancelThreadpoolIo , чтобы отменить это уведомление.

Если дескриптор файла, привязанный к объекту завершения ввода-вывода, имеет режим уведомлений FILE_SKIP_COMPLETION_PORT_ON_SUCCESS и асинхронная операция ввода-вывода возвращается немедленно с успехом, функция обратного вызова завершения ввода-вывода объекта не вызывается и уведомления о потоке ввода-вывода должны быть отменены. Дополнительные сведения см. в разделе CancelThreadpoolIo.

Чтобы скомпилировать приложение, использующее эту функцию, определите _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

См. также

CancelThreadpoolIo

CloseThreadpoolIo

CreateThreadpoolIo

Пулы потоков

WaitForThreadpoolIoCallbacks