Funzione CreateFiberEx (winbase.h)

Articolo
03/13/2024

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

Sintassi

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

Parametri

[in] dwStackCommitSize

Dimensioni iniziali del 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] dwStackReserveSize

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

[in] dwFlags

Se questo parametro è zero, lo stato a virgola mobile nei sistemi x86 non viene commutato e i dati possono essere danneggiati se una fibra usa l'aritmetica a virgola mobile. Se questo parametro è FIBER_FLAG_FLOAT_SWITCH, lo stato a virgola mobile viene commutato per la fibra.

Windows XP: Il flag FIBER_FLAG_FLOAT_SWITCH non è supportato.

[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 fiber, 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. Per impostazione predefinita, ogni fibra ha 1 megabyte di spazio dello stack riservato. Pertanto, è possibile creare al massimo 2028 fibre. Se si riducono le dimensioni predefinite dello stack, è possibile creare più fibre. Tuttavia, l'applicazione avrà prestazioni migliori se si usa una strategia alternativa per l'elaborazione delle richieste.

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

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll