Функция ConvertThreadToFiber (winbase.h)

Статья
03/03/2024

Преобразует текущий поток в волокно. Перед планированием других волокон необходимо преобразовать поток в волокно.

Синтаксис

LPVOID ConvertThreadToFiber(
  [in, optional] LPVOID lpParameter
);

Параметры

[in, optional] lpParameter

Указатель на переменную, передаваемую волокну. Волокно может получить эти данные с помощью макроса GetFiberData .

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

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

Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Другие волокна могут выполнять только волокна. Если потоку необходимо выполнить волокно, он должен вызвать ConvertThreadToFiber или ConvertThreadToFiberEx , чтобы создать область, в которой будут сохраняться сведения о состоянии волокон. Поток теперь является текущим волокном. Сведения о состоянии для этого волокна включают данные волокон, указанные в параметре lpParameter.

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0400 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Примеры

Пример см. в разделе Использование волокон.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll