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

Статья
03/02/2024

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

Синтаксис

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

См. также

WaitForThreadpoolIoCallbacks