Función CreateFiberEx (winbase.h)

Artículo
08/27/2023

Asigna un objeto de fibra, lo asigna a una pila y configura la ejecución para comenzar en la dirección de inicio especificada, normalmente la función de fibra. Esta función no programa la fibra.

Sintaxis

LPVOID CreateFiberEx(
  [in]           SIZE_T                dwStackCommitSize,
  [in]           SIZE_T                dwStackReserveSize,
  [in]           DWORD                 dwFlags,
  [in]           LPFIBER_START_ROUTINE lpStartAddress,
  [in, optional] LPVOID                lpParameter
);

Parámetros

[in] dwStackCommitSize

Tamaño de confirmación inicial de la pila, en bytes. Si este parámetro es cero, la nueva fibra usa el tamaño predeterminado de la pila de confirmación para el ejecutable. Para obtener más información, consulte Tamaño de pila de subprocesos.

[in] dwStackReserveSize

Tamaño de reserva inicial de la pila, en bytes. Si este parámetro es cero, la nueva fibra usa el tamaño de pila reservado predeterminado para el ejecutable. Para obtener más información, consulte Tamaño de pila de subprocesos.

[in] dwFlags

Si este parámetro es cero, el estado de punto flotante en los sistemas x86 no se cambia y los datos se pueden dañar si una fibra usa aritmética de punto flotante. Si este parámetro es FIBER_FLAG_FLOAT_SWITCH, el estado de punto flotante se cambia para la fibra.

Windows XP: No se admite la marca FIBER_FLAG_FLOAT_SWITCH .

[in] lpStartAddress

Puntero a la función definida por la aplicación que ejecutará la fibra y representa la dirección inicial de la fibra. La ejecución de la fibra recién creada no comienza hasta que otra fibra llama a la función SwitchToFiber con esta dirección. Para obtener más información sobre la función de devolución de llamada de fibra, consulte FiberProc.

[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

El número de fibras que puede crear un proceso está limitado por la memoria virtual disponible. De forma predeterminada, cada fibra tiene 1 megabyte de espacio de pila reservado. Por lo tanto, puede crear como máximo 2028 fibras. Si reduce el tamaño de pila predeterminado, puede crear más fibras. Sin embargo, la aplicación tendrá un mejor rendimiento si usa una estrategia alternativa para procesar solicitudes.

Para que un subproceso pueda programar una fibra mediante la función SwitchToFiber , debe llamar a la función ConvertThreadToFiber para que haya una fibra asociada al subproceso.

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.

Requisitos

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