Función ConvertThreadToFiber (winbase.h)

Artículo
03/03/2024

Convierte el hilo actual en una fibra. Debe convertir un hilo en una fibra para poder programar otras fibras.

Sintaxis

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

Parámetros

[in, optional] lpParameter

Puntero a una variable que se pasa a la fibra. La fibra puede recuperar estos datos mediante la macro GetFiberData .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es la dirección de la fibra.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Solo las fibras pueden ejecutar otras fibras. Si un subproceso necesita ejecutar una fibra, debe llamar a ConvertThreadToFiber o ConvertThreadToFiberEx para crear un área en la que se guarde información de estado de fibra. El hilo es ahora la fibra actual. La información de estado de esta fibra incluye los datos de fibra especificados por lpParameter.

Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0400 o posterior. Para obtener más información, vea Uso de los encabezados de Windows.

Ejemplos

Para obtener un ejemplo, consulte Uso de fibras.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll