ConvertThreadToFiber

Overview

Group

Quick Info

Windows NT
Yes
Win95
No
Win32s
No
Import Library
kernel32.lib
Header File
winbase.h
Unicode
No
Platform Notes
None

The ConvertTheadToFiber function converts the current thread into a fiber. You must convert a thread into a fiber before you can schedule other fibers.

LPVOID ConvertThreadToFiber(

LPVOID lpParameter	// fiber data for new fiber
);

Parameters
lpParameter

Specifies a single variable that is passed to the fiber. The fiber can retrieve this value by using the GetFiberData function.

Return Values
If the function succeeds, the return value is the address of the fiber.

If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks
Only fibers can execute other fibers. If a thread needs to execute a fiber, it must call ConvertThreadToFiber to create an area in which to save fiber state information. The thread is now the current fiber. The state information for this fiber includes the fiber data specified by lpParameter.