Funzione CreateFiber (winbase.h)

Articolo
08/27/2023

Alloca un oggetto fiber, lo assegna uno stack e imposta l'esecuzione per iniziare all'indirizzo iniziale specificato, in genere la funzione fibre. Questa funzione non pianifica la fibra.

Per specificare sia le dimensioni dello stack di commit che di riserva, usare la funzione CreateFiberEx .

Sintassi

LPVOID CreateFiber(
  [in]           SIZE_T                dwStackSize,
  [in]           LPFIBER_START_ROUTINE lpStartAddress,
  [in, optional] LPVOID                lpParameter
);

Parametri

[in] dwStackSize

Dimensioni iniziali di commit dello stack, in byte. Se questo parametro è zero, la nuova fibra usa le dimensioni predefinite dello stack di commit per l'eseguibile. Per altre informazioni, vedere Dimensioni dello stack di thread.

[in] lpStartAddress

Puntatore alla funzione definita dall'applicazione da eseguire dalla fibra e rappresenta l'indirizzo iniziale della fibra. L'esecuzione della fibra appena creata non inizia fino a quando un'altra fibra chiama la funzione SwitchToFiber con questo indirizzo. Per altre informazioni sulla funzione di callback fibre, vedere FiberProc.

[in, optional] lpParameter

Puntatore a una variabile passata alla fibra. La fibra può recuperare questi dati usando la macro GetFiberData .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è l'indirizzo della fibra.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Il numero di fibre che un processo può creare è limitato dalla memoria virtuale disponibile. Ad esempio, se si crea ogni fibra con 1 megabyte di spazio dello stack riservato, è possibile creare al massimo 2028 fibre. Se si riducono le dimensioni predefinite dello stack usando l'istruzione STACKSIZE nel file di definizione del modulo (.def) o usando CreateFiberEx, è possibile creare più fibre. Tuttavia, l'applicazione avrà prestazioni migliori se si usa una strategia alternativa per l'elaborazione delle richieste anziché creare un numero elevato di fibre.

Prima che un thread possa pianificare una fibra usando la funzione SwitchToFiber , deve chiamare la funzione ConvertThreadToFiber in modo che esista una fibra associata al thread.

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0400 o versioni successive. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Esempio

Per un esempio, vedere Uso di fibre.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll